文档中心 > API类目 > 物流宝API

taobao.wlb.item.query (分页查询商品)

根据状态、卖家、SKU等信息查询商品列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
name String 可选 test 商品名称
title String 可选 test
  • 最大长度:255
  • 商品前台销售名字
    item_code String 可选 test
  • 最大长度:64
  • 商家编码
    is_sku String 可选 true 是否是最小库存单元,只有最小库存单元的商品才可以有库存,值只能给"true","false"来表示; 若值不在范围内,则按true处理
    parent_id Number 可选 1000 父ID,只有is_sku=1时才能有父ID,商品也可以没有付商品
    status String 可选 ITEM_STATUS_VALID 只能输入以下值或空: ITEM_STATUS_VALID -- 1 表示 有效; ITEM_STATUS_LOCK -- 2 表示锁住。 若值不在范围内,按ITEM_STATUS_VALID处理
    item_type String 可选 NORMAL ITEM类型(只允许输入以下英文或空) NORMAL 0:普通商品; COMBINE 1:是否是组合商品 DISTRIBUTION 2:是否是分销商品(货主是别人) 若值不在范围内,则按NORMAL处理
    page_no Number 可选 1
  • 默认值:1
  • 当前页
    page_size Number 可选 20
  • 默认值:20
  • 分页记录个数,如果用户输入的记录数大于50,则一页显示50条记录

    响应参数

    名称 类型 示例值 描述
    total_count Number 100 结果总数
    item_list WlbItem [] 商品信息列表
    • └ id
    • Number
    • 1001
    • 商品id
    • └ user_id
    • Number
    • 1000
    • 商品所有人淘宝ID
    • └ user_nick
    • String
    • test
    • 商品所有人淘宝nick
    • └ name
    • String
    • 商品A
    • 商品的名称
    • └ title
    • String
    • 超低价商品A
    • 前台商品名称
    • └ item_code
    • String
    • A0001
    • 商家编码
    • └ is_sku
    • Boolean
    • true
    • 是不是sku商品 值为true或false
    • └ flag
    • String
    • BIT_HAS_AUTHORIZE,BATCH,SYNCHRONIZATION
    • 标记,用逗号隔开的字符串。 BIT_HAS_AUTHORIZE 第1位 是否有授权规则; BATCH 第2位 是否有批次规则; SYNCHRONIZATION 第3位 是否有同步规则。
    • └ type
    • String
    • NORMAL
    • 商品类型: NORMAL--普通类型; COMBINE--组合商品; DISTRIBUTION--分销商品; 默认为NORMAL
    • └ remark
    • String
    • 填写备注
    • 商品备注
    • └ parent_id
    • Number
    • 1000
    • 父item的id,当item为物流宝子商品时,parent_id必填,否则不必填 可通过父ID来得知商品的关系。
    • └ status
    • String
    • item_status_valid
    • 状态,item_status_valid -- 1 表示 有效 item_status_lock -- 2 表示锁住
    • └ publish_version
    • Number
    • 1
    • 发布版本号,用来同步商
    • └ creator
    • String
    • test
    • 创建人
    • └ brand_id
    • Number
    • 1000
    • 品牌ID
    • └ gmt_create
    • Date
    • 2000-01-01 00:00:00
    • 创建日期
    • └ last_modifier
    • String
    • test
    • 最后修改人
    • └ gmt_modified
    • Date
    • 2000-01-01 00:00:00
    • 修改日期
    • └ properties
    • String
    • test
    • 属性key:value; key:value
    • └ is_friable
    • Boolean
    • true
    • 是否易碎
    • └ is_dangerous
    • Boolean
    • true
    • 是否危险品
    • └ color
    • String
    • red
    • 颜色
    • └ weight
    • Number
    • 10
    • 重量
    • └ length
    • Number
    • 10
    • mm
    • └ width
    • Number
    • 10
    • └ height
    • Number
    • 10
    • └ volume
    • Number
    • 10
    • 立方mm
    • └ goods_cat
    • String
    • test
    • 货类
    • └ pricing_cat
    • String
    • test
    • 计价货类
    • └ package_material
    • String
    • test
    • 包装材料
    • └ price
    • Number
    • 10
    • 价格

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    WlbItemQueryRequest req = new WlbItemQueryRequest();
    req.setName("test");
    req.setTitle("test");
    req.setItemCode("test");
    req.setIsSku("true");
    req.setParentId(1000L);
    req.setStatus("ITEM_STATUS_VALID");
    req.setItemType("NORMAL");
    req.setPageNo(1L);
    req.setPageSize(20L);
    WlbItemQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <wlb_item_query_response>
        <total_count>100</total_count>
        <item_list>
            <wlb_item>
                <id>1001</id>
                <user_id>1000</user_id>
                <user_nick>test</user_nick>
                <name>商品A</name>
                <title>超低价商品A</title>
                <item_code>A0001</item_code>
                <is_sku>true</is_sku>
                <flag>BIT_HAS_AUTHORIZE,BATCH,SYNCHRONIZATION</flag>
                <type>NORMAL</type>
                <remark>填写备注</remark>
                <parent_id>1000</parent_id>
                <status>item_status_valid</status>
                <publish_version>1</publish_version>
                <creator>test</creator>
                <brand_id>1000</brand_id>
                <gmt_create>2000-01-01 00:00:00</gmt_create>
                <last_modifier>test</last_modifier>
                <gmt_modified>2000-01-01 00:00:00</gmt_modified>
                <properties>test</properties>
                <is_friable>true</is_friable>
                <is_dangerous>true</is_dangerous>
                <color>red</color>
                <weight>10</weight>
                <length>10</length>
                <width>10</width>
                <height>10</height>
                <volume>10</volume>
                <goods_cat>test</goods_cat>
                <pricing_cat>test</pricing_cat>
                <package_material>test</package_material>
                <price>10</price>
            </wlb_item>
        </item_list>
    </wlb_item_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.wlb-error:10029 参数为空 检查必填参数是否填写
    isv.wlb-error:10055 输入参数非法 检查参数是否按规则填写
    isv.wlb-error:00000 系统异常 请联系ISP

    API工具

    如何获得此API

    FAQ

    返回
    顶部