tmall.channel.products.query (渠道中心-查询产品列表)

渠道中心,供应商查询其产品数据,返回同时符合所有查询条件的产品信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
product_number String 可选 1 商家产品编码
sku_number String 可选 1 商家SKU编码
product_ids Number [] 可选 1
  • 最大列表长度:20
  • 产品Id
    page_size Number 必须 20 分页大小
    product_line_id Number 可选 2 产品线Id
    page_num Number 必须 1 页码数,从1开始

    响应参数

    名称 类型 示例值 描述
    result PageResultDto 1 result
    • └ error_message
    • String
    • 入参无效
    • 异常信息
    • product_list
    • ProductTopDto []
    • list
    • 产品信息
    • └ product_line_id
    • Number
    • 123
    • 产品线ID
    • └ product_number
    • String
    • 12
    • 产品编码
    • └ desc_path
    • String
    • http://img.cdn.tao/***
    • 产品描述地址
    • └ standard_price
    • Number
    • 100
    • 基准价
    • └ title
    • String
    • 测试标题
    • 标题
    • └ product_id
    • Number
    • 1
    • 产品Id
    • └ sc_item_id
    • Number
    • 1
    • 没有sku的情况下,产品对应的后端商品id
    • └ spu_id
    • Number
    • 1
    • spuId
    • └ supplier_id
    • Number
    • 1
    • 供应商Id
    • └ category_id
    • Number
    • 1
    • 类目Id
    • sku_list
    • ProductSkuTopDto []
    • 34
    • sku列表
    • └ sku_id
    • Number
    • 543456
    • skuId
    • └ sku_number
    • String
    • yurfsgsr
    • sku商家编码
    • └ sku_sc_item_id
    • Number
    • 435
    • sku后端货品
    • └ standard_price
    • Number
    • 2142
    • 基准价
    • └ bar_code
    • String
    • 22354354
    • 条形码
    • └ picture_url
    • String
    • http://img.cdn.tao/***
    • 图片链接
    • └ total_count
    • Number
    • 100
    • 总数
    • └ has_next
    • Boolean
    • true
    • 是否有下一页
    • └ error_code
    • String
    • exp
    • 错误码
    • └ success
    • Boolean
    • true
    • 是否查询成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallChannelProductsQueryRequest req = new TmallChannelProductsQueryRequest();
    req.setProductNumber("1");
    req.setSkuNumber("1");
    req.setProductIds("1");
    req.setPageSize(20L);
    req.setProductLineId(2L);
    req.setPageNum(1L);
    TmallChannelProductsQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_channel_products_query_response>
        <result>
            <error_message>入参无效</error_message>
            <product_list>
                <product_top_dto>
                    <product_line_id>123</product_line_id>
                    <product_number>12</product_number>
                    <desc_path>http://img.cdn.tao/***</desc_path>
                    <standard_price>100</standard_price>
                    <title>测试标题</title>
                    <product_id>1</product_id>
                    <sc_item_id>1</sc_item_id>
                    <spu_id>1</spu_id>
                    <supplier_id>1</supplier_id>
                    <category_id>1</category_id>
                    <sku_list>
                        <product_sku_top_dto>
                            <sku_id>543456</sku_id>
                            <sku_number>yurfsgsr</sku_number>
                            <sku_sc_item_id>435</sku_sc_item_id>
                            <standard_price>2142</standard_price>
                            <bar_code>22354354</bar_code>
                            <picture_url>http://img.cdn.tao/***</picture_url>
                        </product_sku_top_dto>
                    </sku_list>
                </product_top_dto>
            </product_list>
            <total_count>100</total_count>
            <has_next>true</has_next>
            <error_code>exp</error_code>
            <success>true</success>
        </result>
    </tmall_channel_products_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

    返回
    顶部