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

taobao.opentrade.queue.users.mark (尖货交易可购买用户标记)

尖货交易用户标记信息回传,根据openId标记用户可购买商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
status String 必须 LUCK 用户状态,可任意传入,后续查询返回
activity_id String 可选 2132 排队活动ID,排队时如传入,这里需要填写;若未传,这里也可以不传
sku_id Number 必须 0 排队商品SKU ID,不存在传0
item_id Number 必须 123456 排队商品ID
open_user_ids String [] 必须 adad1213,asdadsr332
  • 最大列表长度:20
  • 本次待标记的用户列表,多个以逗号(,)分割,最大20个
    hit Boolean 必须 true 是否目标用户,传入true后,用户可购买商品

    响应参数

    名称 类型 示例值 描述
    result Number 3 标记成功的用户数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OpentradeQueueUsersMarkRequest req = new OpentradeQueueUsersMarkRequest();
    req.setStatus("LUCK");
    req.setActivityId("2132");
    req.setSkuId(0L);
    req.setItemId(123456L);
    req.setOpenUserIds("adad1213,asdadsr332");
    req.setHit(true);
    OpentradeQueueUsersMarkResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <opentrade_queue_users_mark_response>
        <result>3</result>
    </opentrade_queue_users_mark_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

    返回
    顶部