taobao.cornucopia.award.external.usage.query (数字虚拟-权益外放-核销查询)

数字虚拟-权益外放-核销查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
quanyi_isv_query_usage_req QuanyiIsvQueryUsageReq 可选 请求入参
  • └ out_id
  • String
  • 必须
  • 123456
  • 权益发放时传入的幂等字段,全局唯一
  • └ open_uid
  • String
  • 必须
  • A1H10ndlAOUlvimO48Gh6Och
  • 用户id,openuId

响应参数

名称 类型 示例值 描述
result CommonResult result
  • data
  • AwardExternalQueryUsageDTO
  • data
  • └ buyer_nick
  • String
  • 熟*蛋
  • 淘宝账户nick
  • └ use_time
  • String
  • 2024-01-29 12:43:59
  • status == -2时有值
  • └ send_time
  • String
  • 2024-01-29 12:43:59
  • 权益发放时间
  • └ status
  • Number
  • 2
  • 状态 可用(有效):1 已冻结:0 手动删除(只保留3天):-1 已核销:-2 已过期:9
  • └ status_desc
  • String
  • 可用
  • status描述值
  • └ success
  • Boolean
  • true
  • 标识调用是否成功
  • └ err_code
  • String
  • SUCCESS
  • 调用出错时的错误码
  • └ err_msg
  • String
  • 成功
  • 调用出错时的错误描述

请求示例

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

响应示例

  • XML示例
  • JSON示例
<cornucopia_award_external_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>2</status>
            <status_desc>可用</status_desc>
        </data>
        <success>true</success>
        <err_code>SUCCESS</err_code>
        <err_msg>成功</err_msg>
    </result>
</cornucopia_award_external_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

返回
顶部