文档中心 > API类目 > 淘宝买菜次日达-快递送达

alibaba.tbmc.item.page.query (淘宝买菜开放平台商品分页查询接口)

淘宝买菜开放平台商品分页查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_query_request ItemQueryRequest 可选 request
  • └ scroll_expire
  • String
  • 可选
  • 100
  • scroll过期时间
  • └ sku_code_list
  • String []
  • 可选
  • 123
  • 商品编码list
  • └ barcode_list
  • String []
  • 可选
  • 123
  • 条码list
  • └ platform_merchant_code
  • String
  • 可选
  • CSMMC
  • 租户编码
  • └ supplier_no
  • String
  • 必须
  • 123456
  • 二级供应商编码
  • └ page_size
  • Number
  • 可选
  • 20
  • 每页个数
  • └ scroll_id
  • String
  • 可选
  • 13ui3
  • 第一次调用搜索方法会返回scroll_id 但并不包含数据,后续每次搜索都必须指定上一次返回scroll_id,并且后续搜索结果中都会返回scroll_id及对应匹配的数据,后续查询该参数必填
  • └ page_index
  • Number
  • 可选
  • 1
  • 当前页
  • └ org_no
  • String
  • 必须
  • 8768909
  • 子公司编码

响应参数

名称 类型 示例值 描述
result ScrollResult result
  • └ code
  • String
  • system_error
  • 错误编码
  • └ success
  • Boolean
  • true
  • success
  • └ message
  • Boolean
  • 系统错误
  • 错误信息
  • └ scroll_id
  • String
  • eJxdzr2OwjAMB/CnSRcWx/lqhg6oiA2We4CoCgECbVKSVjp4+kuvU5EsWfL/Z8um7/Jk7JxyTI0A4Cg1oOJCVybb1Bv3O5rJD66hUgtArhSlDKprTEM3NY8cQ/WaXXo3NoarvxF2WCPC9ktIsE0udeFJxDH7jytjBCAoS/3vlQWC9eCSvXdhKsrGy6IIqvbndGpLJ6h3+/NhV1yex7H3LhUX4qqwZkBV+fpLPufNMSYlKM6Bf7F7HIvzl1VR0IzVlAm9ZctzwfWbixxX8we67FsV
  • 循环查询id
  • data
  • ItemDTO []
  • 商品列表
  • └ sku_code
  • String
  • 123
  • 商品编码
  • └ sku_name
  • String
  • 飘柔
  • 商品名称
  • └ barcode_list
  • String []
  • 商品主条码
  • └ forest_cat_id
  • Number
  • 231
  • forest叶子类目(类目id)
  • └ forest_cat_name
  • String
  • 水果
  • forest叶子类目名称(类目名称)
  • └ brand
  • String
  • 华为
  • 品牌
  • item_spec_dtos
  • ItemSpecDTO []
  • 规格信息
  • └ spec_name
  • String
  • 规格
  • 笛卡尔集规格名称
  • └ sku_id
  • Number
  • 123
  • 子品skuId
  • └ spec_barcode_list
  • String []
  • 规格条码
  • └ spec_sku_code
  • String []
  • qwe
  • 规格货品编码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaTbmcItemPageQueryRequest req = new AlibabaTbmcItemPageQueryRequest();
AlibabaTbmcItemPageQueryRequest.ItemQueryRequest obj1 = new AlibabaTbmcItemPageQueryRequest.ItemQueryRequest();
obj1.setScrollExpire("100");
obj1.setSkuCodeList("123");
obj1.setBarcodeList("123");
obj1.setPlatformMerchantCode("CSMMC");
obj1.setSupplierNo("123456");
obj1.setPageSize(20L);
obj1.setScrollId("13ui3");
obj1.setPageIndex(1L);
obj1.setOrgNo("8768909");
req.setItemQueryRequest(obj1);
AlibabaTbmcItemPageQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_tbmc_item_page_query_response>
    <result>
        <code>system_error</code>
        <success>true</success>
        <message>系统错误</message>
        <scroll_id>eJxdzr2OwjAMB/CnSRcWx/lqhg6oiA2We4CoCgECbVKSVjp4+kuvU5EsWfL/Z8um7/Jk7JxyTI0A4Cg1oOJCVybb1Bv3O5rJD66hUgtArhSlDKprTEM3NY8cQ/WaXXo3NoarvxF2WCPC9ktIsE0udeFJxDH7jytjBCAoS/3vlQWC9eCSvXdhKsrGy6IIqvbndGpLJ6h3+/NhV1yex7H3LhUX4qqwZkBV+fpLPufNMSYlKM6Bf7F7HIvzl1VR0IzVlAm9ZctzwfWbixxX8we67FsV</scroll_id>
        <data>
            <item_d_t_o>
                <sku_code>123</sku_code>
                <sku_name>飘柔</sku_name>
                <forest_cat_id>231</forest_cat_id>
                <forest_cat_name>水果</forest_cat_name>
                <brand>华为</brand>
                <item_spec_dtos>
                    <item_spec_d_t_o>
                        <spec_name>规格</spec_name>
                        <sku_id>123</sku_id>
                        <spec_sku_code>
                            <string>qwe</string>
                        </spec_sku_code>
                    </item_spec_d_t_o>
                </item_spec_dtos>
            </item_d_t_o>
        </data>
    </result>
</alibaba_tbmc_item_page_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

返回
顶部