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

taobao.wlb.item.get (根据商品ID获取商品信息)

根据商品ID获取商品信息,除了获取商品信息外还可获取商品属性信息和库存信息。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 1000
  • 最大长度:20
  • 商品ID

    响应参数

    名称 类型 示例值 描述
    item 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);
    WlbItemGetRequest req = new WlbItemGetRequest();
    req.setItemId(1000L);
    WlbItemGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <wlb_item_get_response>
        <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>
        </item>
    </wlb_item_get_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 输入参数非法 检查参数是否按规则填写
    isp.wlb-error:00002 系统异常 请联系ISP

    API工具

    如何获得此API

    FAQ

    返回
    顶部