文档中心 > API类目 > 阿里通信API

taobao.promotion.activity.award.usage.query (权益使用状态查询)

权益使用状态查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
quanyi_isv_query_usage_req QuanyiIsvQueryUsageReq 可选 权益使用状态查询对象
  • └ out_id
  • String
  • 必须
  • 123456
  • 幂等字段,即请求流水

响应参数

名称 类型 示例值 描述
result CommonResult result
  • data
  • AwardExternalQueryUsageDTO
  • data
  • └ buyer_nick
  • String
  • 熟*蛋
  • buyerNick
  • └ use_time
  • String
  • 2024-01-29 12:43:59
  • status == -2时有值
  • └ send_time
  • String
  • 2024-01-29 12:43:59
  • sendTime
  • └ status
  • Number
  • 1
  • 状态 可用(有效):1 已冻结:0 手动删除(只保留3天):-1 已核销:-2 已过期:9
  • └ status_desc
  • String
  • 可用
  • status描述值
  • └ err_code
  • String
  • SUCCESS
  • errCode
  • └ success
  • Boolean
  • true
  • success
  • └ err_msg
  • String
  • SUCCESS
  • errMsg

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PromotionActivityAwardUsageQueryRequest req = new PromotionActivityAwardUsageQueryRequest();
PromotionActivityAwardUsageQueryRequest.QuanyiIsvQueryUsageReq obj1 = new PromotionActivityAwardUsageQueryRequest.QuanyiIsvQueryUsageReq();
obj1.setOutId("123456");
req.setQuanyiIsvQueryUsageReq(obj1);
PromotionActivityAwardUsageQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<promotion_activity_award_usage_query_response>
    <result>
        <data>
            <buyer_nick>熟*蛋</buyer_nick>
            <use_time>2024-01-29 12:43:59</use_time>
            <send_time>2024-01-29 12:43:59</send_time>
            <status>1</status>
            <status_desc>可用</status_desc>
        </data>
        <err_code>SUCCESS</err_code>
        <success>true</success>
        <err_msg>SUCCESS</err_msg>
    </result>
</promotion_activity_award_usage_query_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

返回
顶部