文档中心 > API类目 > 猫超卡活动API

tmall.supermarket.card.benefits.issue (天猫超市-超市卡权益发放)

天猫超市-超市卡权益发放

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
card_benefit_issue_request CardBenefitIssueRequest 必须 权益发放请求
  • └ benefits
  • String []
  • 可选
  • ["1234567890"]
  • 权益编码集合,领取模式必填
  • └ mobile
  • String
  • 可选
  • 13000000000
  • 用户手机号,用于确定获奖用户。手机号/昵称二选一,优先手机号定位
  • └ idempotent_id
  • String
  • 必须
  • abcdefg1234567890
  • 权益发放幂等id
  • └ channel_code
  • String
  • 必须
  • channel_code
  • 投放渠道编码
  • └ user_nick
  • String
  • 可选
  • user_nick
  • 用户淘宝昵称,用于确定获奖用户。手机号/昵称二选一,优先手机号定位

响应参数

名称 类型 示例值 描述
result Result 权益发放结果
  • data
  • CardBenefitIssueResonse
  • 权益发放结果信息
  • └ result_code
  • String
  • SUCCESS
  • 权益发放结果 SUCCESS=发放成功 PARTIAL_SUCCESS=部分成功 FAIL=发放失败
  • └ success
  • Boolean
  • true
  • 接口调用是否成功
  • └ error_code
  • String
  • PARAMETER_ERROR
  • 错误编码
  • └ error_msg
  • String
  • channel_code is blank
  • 错误描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallSupermarketCardBenefitsIssueRequest req = new TmallSupermarketCardBenefitsIssueRequest();
TmallSupermarketCardBenefitsIssueRequest.CardBenefitIssueRequest obj1 = new TmallSupermarketCardBenefitsIssueRequest.CardBenefitIssueRequest();
obj1.setBenefits(""1234567890"");
obj1.setMobile("13000000000");
obj1.setIdempotentId("abcdefg1234567890");
obj1.setChannelCode("channel_code");
obj1.setUserNick("user_nick");
req.setCardBenefitIssueRequest(obj1);
TmallSupermarketCardBenefitsIssueResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_supermarket_card_benefits_issue_response>
    <result>
        <data>
            <result_code>SUCCESS</result_code>
        </data>
        <success>true</success>
        <error_code>PARAMETER_ERROR</error_code>
        <error_msg>channel_code is blank</error_msg>
    </result>
</tmall_supermarket_card_benefits_issue_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
SYSTEM_ERROR 系统异常,请联系API接口联系人 请联系API接口联系人
OPERATE_FREQUENTLY 操作频繁,请稍候再试 请稍候再试
PARAMETER_ERROR 参数错误的描述,如channel_code is blank 依据文档要求传入正确的参数
BENEFITS_NOT_EXIST 权益不存在 请传递正确的权益编码
BENEFITS_CONFIG_ERROR 权益配置错误 配置正确的权益
ILLEGAL_BENEFITS_REQUEST 不合法的权益信息 请传递正确的权益信息
BENEFITS_CHANGED 权益信息已更新,请重新获取 重新获取权益内容
USER_IDENTIFY_FAIL 用户识别失败 请传递正确的用户信息

API工具

如何获得此API

FAQ

返回
顶部