文档中心 > API类目 > 淘宝商品API

taobao.skus.custom.get (根据外部ID取商品SKU)

跟据卖家设定的Sku的外部id获取商品，如果一个outer_id对应多个Sku会返回所有符合条件的sku 这个Sku所属卖家从传入的session中获取，需要session绑定(注：iid标签里是num_iid的值，可以用作num_iid使用)

公共参数

请求地址：

环境	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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
fields	String	必须	sku_id,properties		需返回的字段列表。可选值：Sku结构体中的所有字段；字段之间用“,”隔开
outer_id	String	必须	bb		Sku的外部商家ID

响应参数

名称	类型	示例值	描述
skus	Sku []		Sku对象，具体字段以fields决定
└ sku_id Number 123 sku的id └ iid String asdf12323adfaa sku所属商品id(注意：iid近期即将废弃，请用num_iid参数) └ properties String 1243:1215;5626:5125 sku的销售属性组合字符串（颜色，大小，等等，可通过类目API获取某类目下的销售属性）,格式是p1:v1;p2:v2 └ properties_name String 20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1 sku所对应的销售属性的中文名字串，格式如：pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2…… └ quantity Number 3 属于这个sku的商品的数量， └ price String 200.07 属于这个sku的商品的价格取值范围:0-100000000;精确到2位小数;单位:元。如:200.07，表示:200元7分。 └ outer_id String 12345 商家设置的外部id。天猫和集市的卖家，需要登录才能获取到自己的商家编码，不能获取到他人的商家编码。 └ created String 2009-11-04 15:24:43 sku创建日期时间格式：yyyy-MM-dd HH:mm:ss └ modified String 2009-11-04 15:24:43 sku最后修改日期时间格式：yyyy-MM-dd HH:mm:ss └ status String normal sku状态。 normal:正常；delete:删除 └ num_iid Number 12345 sku所属商品数字id

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SkusCustomGetRequest req = new SkusCustomGetRequest();
req.setFields("sku_id,properties");
req.setOuterId("bb");
SkusCustomGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<skus_custom_get_response>
    <skus>
        <sku>
            <sku_id>123</sku_id>
            <iid>asdf12323adfaa</iid>
            <properties>1243:1215;5626:5125</properties>
            <properties_name>20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1</properties_name>
            <quantity>3</quantity>
            <price>200.07</price>
            <outer_id>12345</outer_id>
            <created>2009-11-04 15:24:43</created>
            <modified>2009-11-04 15:24:43</modified>
            <status>normal</status>
            <num_iid>12345</num_iid>
        </sku>
    </skus>
</skus_custom_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.item-skus-custom-get-service-error:ITEM_NOT_FOUND	没有找到宝贝	没有找到宝贝
isp.top-remote-connection-timeout-tmall	系统超时	请稍后重试
isp.top-remote-method-connection-error-tmall	系统错误	请稍后重试
isp.service-unavailable	系统错误	偶尔出现重试，频繁出现反馈平台

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

淘宝商品API

taobao.skus.custom.get (根据外部ID取商品SKU)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ