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

taobao.opentrade.special.users.query (专属下单标记信息查询)

专属下单标记信息查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 必须 100 分页参数,每页大小
open_user_ids String [] 可选 adada,1231asdas,dasdq2eq
  • 最大列表长度:999
  • 用户openId列表,多个以逗号(,)分割
    item_id Number 必须 12345 商品ID
    sku_id Number 可选 0 商品SKU ID,不存在传0
    status String 可选 MARK 用户状态
    page_index Number 必须 0 分页参数,当前页,以0开始

    响应参数

    名称 类型 示例值 描述
    results MarkUserInfo [] [] 标记用户数据
    • └ user_open_id
    • String
    • adb12323
    • 用户openId
    • └ item_id
    • Number
    • 123456
    • 商品ID
    • └ sku_id
    • Number
    • 0
    • 商品SKU ID
    • └ quality
    • Number
    • 1
    • 专属下单商品数量
    • └ status
    • String
    • MARK
    • 用户状态
    total_count Number 3 总记录数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OpentradeSpecialUsersQueryRequest req = new OpentradeSpecialUsersQueryRequest();
    req.setPageSize(100L);
    req.setOpenUserIds("adada,1231asdas,dasdq2eq");
    req.setItemId(12345L);
    req.setSkuId(0L);
    req.setStatus("MARK");
    req.setPageIndex(0L);
    OpentradeSpecialUsersQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <opentrade_special_users_query_response>
        <results>
            <mark_user_info>
                <user_open_id>adb12323</user_open_id>
                <item_id>123456</item_id>
                <sku_id>0</sku_id>
                <quality>1</quality>
                <status>MARK</status>
            </mark_user_info>
        </results>
        <total_count>3</total_count>
    </opentrade_special_users_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

    返回
    顶部