淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
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>

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

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测试工具错误码查询工具 SDK下载

API文档

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

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ