文档中心 > API类目 > 交易开放

taobao.opentrade.queue.query (尖货交易排队信息查询)

尖货交易排队信息查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
status String 可选 NEW 排队用户状态,新用户为NEW
activity_id String 可选 2132 排队活动ID,排队时如传入,这里需要填写;若未传,这里也可以不传
sku_id Number 可选 0 排队商品SKU ID,不存在传0
item_id Number 必须 123456 排队商品ID
page_size Number 必须 100 分页参数,每页大小
page_index Number 必须 0 分页参数,当前页,以0开始

响应参数

名称 类型 示例值 描述
total_count String 100 总记录数
results McUserDto [] [] 返回的排队用户数据
  • └ status
  • String
  • NEW
  • 用户状态
  • └ activity_id
  • String
  • 123
  • 排队活动ID
  • └ ext_info
  • String
  • {"key":"value"}
  • 排队传入的扩展信息
  • └ quality
  • Number
  • 1
  • 排队商品数量
  • └ sku_id
  • Number
  • 0
  • 排队商品SKU ID
  • └ item_id
  • Number
  • 123456
  • 排队商品ID
  • └ user_open_id
  • String
  • ads123212313211
  • 用户openId

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OpentradeQueueQueryRequest req = new OpentradeQueueQueryRequest();
req.setStatus("NEW");
req.setActivityId("2132");
req.setSkuId(0L);
req.setItemId(123456L);
req.setPageSize(100L);
req.setPageIndex(0L);
OpentradeQueueQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<opentrade_queue_query_response>
    <total_count>100</total_count>
    <results>
        <mc_user_dto>
            <status>NEW</status>
            <activity_id>123</activity_id>
            <ext_info>{&quot;key&quot;:&quot;value&quot;}</ext_info>
            <quality>1</quality>
            <sku_id>0</sku_id>
            <item_id>123456</item_id>
            <user_open_id>ads123212313211</user_open_id>
        </mc_user_dto>
    </results>
</opentrade_queue_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

返回
顶部