文档中心 > API文档

taobao.omniitem.item.get (获取全渠道门店商品)

通过门店id/类目id/商品id单个或多个参数组合查询全渠道门店商品信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_no Number 可选 1
  • 默认值:1
  • 分页当前页数
    page_size Number 可选 20
  • 默认值:20
  • 分页单页大小
    item_id Number 可选 54321678112 可选,指定获取的商品id
    outer_id String 可选 omni_test_outer_id_1234 可选,指定获取的商品外部id

    响应参数

    名称 类型 示例值 描述
    result PageResult result 返回结果
    • └ message
    • String
    • msg
    • 错误信息
    • └ total_count
    • Number
    • 1000
    • totalCount
    • datas
    • LightItemDo []
    • data
    • 返回查询到的商品列表
    • └ user_id
    • Number
    • 11111111
    • 商品所属商家id
    • └ item_id
    • Number
    • 54321678112
    • 商品淘系id
    • └ operator
    • String
    • 测试账号
    • 操作人
    • └ cat_id
    • Number
    • 126518010
    • 商品叶子类目,参见taobao.omniitem.category.get接口返回值
    • └ title
    • String
    • 宝贝标题
    • 商品标题
    • └ subtitle
    • String
    • 冬季保暖
    • 商品卖点
    • └ store_ids
    • Number []
    • storeIds
    • 关联门店id
    • └ price
    • String
    • 100.00
    • 吊牌价
    • └ desc
    • String
    • 门店商品描述
    • 商品描述
    • skus
    • ItemLightPublishSkuDto []
    • skus
    • sku信息列表
    • └ sku_id
    • Number
    • 12345
    • 淘系skuId
    • └ price
    • String
    • 100.00
    • sku吊牌价
    • └ pretium
    • String
    • 100.00
    • sku销售价
    • └ sku_outer_id
    • String
    • sku12345
    • sku商家编码
    • └ barcode
    • String
    • 6936983800013
    • sku条形码
    • └ custom_code
    • String
    • 暂未启用
    • customCode
    • └ sku_images
    • String []
    • sku关联图片url列表
    • skuImages
    • sale_props
    • ItemLightPublishSalePropDto []
    • salePropsDTO
    • sku销售属性列表
    • └ pid
    • Number
    • 10016
    • 销售属性pid,参见taobao.omniitem.category.get接口返回值
    • └ value
    • String
    • XL
    • 销售属性值
    • └ extend_attr
    • String
    • {}
    • sku扩展字段
    • └ pretium
    • String
    • 100.00
    • 销售价
    • └ outer_id
    • String
    • 12345
    • 商家编码
    • └ barcode
    • String
    • 6936983800013
    • 商品条形码
    • images
    • ItemLightPublishImageDto []
    • images
    • 商品图片,最少1张,最多5张
    • └ url
    • String
    • i7/T1rfxpXcVhXXXH9QcZ_033150.jpg
    • 图片空间URL
    • └ extend_attr
    • String
    • {}
    • 扩展字段
    • └ code
    • String
    • code
    • 错误码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OmniitemItemGetRequest req = new OmniitemItemGetRequest();
    req.setPageNo(1L);
    req.setPageSize(20L);
    req.setItemId(54321678112L);
    req.setOuterId("omni_test_outer_id_1234");
    OmniitemItemGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <omniitem_item_get_response>
        <result>
            <message>msg</message>
            <total_count>1000</total_count>
            <datas>
                <light_item_do>
                    <user_id>11111111</user_id>
                    <item_id>54321678112</item_id>
                    <operator>测试账号</operator>
                    <cat_id>126518010</cat_id>
                    <title>宝贝标题</title>
                    <subtitle>冬季保暖</subtitle>
                    <store_ids>
                        <number>storeIds</number>
                    </store_ids>
                    <price>100.00</price>
                    <desc>门店商品描述</desc>
                    <skus>
                        <item_light_publish_sku_dto>
                            <sku_id>12345</sku_id>
                            <price>100.00</price>
                            <pretium>100.00</pretium>
                            <sku_outer_id>sku12345</sku_outer_id>
                            <barcode>6936983800013</barcode>
                            <custom_code>暂未启用</custom_code>
                            <sku_images>
                                <string>sku关联图片url列表</string>
                            </sku_images>
                            <sale_props>
                                <item_light_publish_sale_prop_dto>
                                    <pid>10016</pid>
                                    <value>XL</value>
                                </item_light_publish_sale_prop_dto>
                            </sale_props>
                            <extend_attr>{}</extend_attr>
                        </item_light_publish_sku_dto>
                    </skus>
                    <pretium>100.00</pretium>
                    <outer_id>12345</outer_id>
                    <barcode>6936983800013</barcode>
                    <images>
                        <item_light_publish_image_dto>
                            <url>i7/T1rfxpXcVhXXXH9QcZ_033150.jpg</url>
                        </item_light_publish_image_dto>
                    </images>
                    <extend_attr>{}</extend_attr>
                </light_item_do>
            </datas>
            <code>code</code>
        </result>
    </omniitem_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部