taobao.promotion.activity.exchangecode.queryrecord (兑换码记录及状态查询)

商家采购权益对应的兑换码,查询兑换码是否已被用户兑换

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
exchange_code String 必须 AFTg76AG 兑换码
ext String 可选 {"key":"value"} 预留扩展入参,JSON格式,暂不使用

响应参数

名称 类型 示例值 描述
result CommonResult 结果对象 接口结果
  • └ code
  • String
  • IE001
  • 错误码
  • └ sub_code
  • String
  • SCUESS
  • 子错误码
  • └ success
  • Boolean
  • true
  • 是否成功
  • model
  • Model
  • 数据对象
  • 数据对象
  • └ status
  • String
  • 0
  • 状态,0未兑换 1已兑换
  • └ benefit_name
  • String
  • 10元天猫红包
  • 权益名称
  • └ exchange_time
  • String
  • 2019-09-19 00:00:00
  • 兑换时间,格式yyyyMMddHHmmss
  • └ buyer_nick
  • String
  • te***t
  • 兑换的淘宝账号,脱敏
  • └ paras
  • String
  • {"resourceCode":1}
  • 其他参数,目前为空
  • └ msg_info
  • String
  • 成功
  • top接口中这两个属性无含义,不需关注
  • └ msg_code
  • String
  • SCUESS
  • top接口中这两个属性无含义,不需关注
  • └ desc
  • String
  • 成功
  • 结果描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PromotionActivityExchangecodeQueryrecordRequest req = new PromotionActivityExchangecodeQueryrecordRequest();
req.setExchangeCode("AFTg76AG");
req.setExt("{\"key\":\"value\"}");
PromotionActivityExchangecodeQueryrecordResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<promotion_activity_exchangecode_queryrecord_response>
    <result>
        <code>IE001</code>
        <sub_code>SCUESS</sub_code>
        <success>true</success>
        <model>
            <status>0</status>
            <benefit_name>10元天猫红包</benefit_name>
            <exchange_time>2019-09-19 00:00:00</exchange_time>
            <buyer_nick>te***t</buyer_nick>
        </model>
        <paras>{&quot;resourceCode&quot;:1}</paras>
        <msg_info>成功</msg_info>
        <msg_code>SCUESS</msg_code>
        <desc>成功</desc>
    </result>
</promotion_activity_exchangecode_queryrecord_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部