淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
booth_id	Number	可选	12345		城市站id
item_id	Number	必须	12345		商品id

名称	类型	示例值	描述
tmall_nrt_item_get	ResultDo		返回结果
data TopHomeItemDto true 是否成功 └ status Number 1 商品状态 └ booth_id String 123 摊位ID └ c_id Number 123 叶子类目ID c_props CategoryPropDto [] 类目属性 └ property_id Number 20000 属性ID └ property_name String 品牌属性名 └ value_id Number 1000 值ID └ value_text String TATA 值名 └ create_time Date 2000-01-01 00:00:00 创建时间 └ dealer_code String dealer01 经销商编码 └ desc String 这是一个好商品描述 ext MacallineItemExtDto 系统自动生成 └ brand_series_id String 100 品牌系列ID └ brand_series_name String 系列A 品牌系列名称 └ charge_unit String BG 计价单位 └ grade Number 1 等级 └ label_price_type Number 1 标签价格类型 original_location LocationDto 产地 └ city String 杭州城市名 └ city_id Number 111 城市ID └ prov String 浙江省份名 └ prov_id Number 111 省份ID └ type Number 1 类型，1：国内，2：国外 └ price_type Number 1 价格类型，1：明码实价，2：明码议价 └ pricer String 测试物价员 └ secondary_steel String 123 辅材 └ specification String 123 规格 └ specification_unit String kg 规格单位 └ substrate String 123 基材 └ support_return_goods Boolean true 是否支持退换货 └ veneer String 124 饰面 └ features String {"aaaa":"bb"} features └ item_id Number 123 商品ID images ItemImageDto [] 图片信息 └ position Number 1 图片次序 └ url String xxxx.jpg 图片地址 └ item_type Number 1 商品类型，1：主商品，2：摊位商品，3：城市站商品 └ main_item_id Number 111 主商品ID └ mall_id String 1111 卖场ID └ outer_id String 123123 商家编码 └ price String 99.99 价格 └ quantity Number 99 数量 skus SkuDto [] SKU └ barcode String 12312312 条码 └ create_time Date 2000-01-01 00:00:00 创建时间 └ outer_id String 12312313 商家编码 └ price String 99.99 价格 properties CategoryPropDto [] SKU属性 └ property_id Number 123131 属性ID └ property_name String 颜色属性名 └ value_id Number 213123 值ID └ value_text String 白色值名称 └ quantity Number 99 数量 └ sku_id Number 12312312 SKU ID └ update_time Date 2000-01-01 00:00:00 修改时间 └ title String 衣柜商品名称 └ update_time Date 2000-01-01 00:00:00 修改时间 └ err_code String sys_err 错误码 └ err_msg String 系统错误错误信息 └ success Boolean true 调用是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrtItemGetRequest req = new TmallNrtItemGetRequest();
req.setBoothId(12345L);
req.setItemId(12345L);
TmallNrtItemGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallNrtItemGetRequest req = new TmallNrtItemGetRequest();
req.BoothId = 12345L;
req.ItemId = 12345L;
TmallNrtItemGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallNrtItemGetRequest;
$req->setBoothId("12345");
$req->setItemId("12345");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=tmall.nrt.item.get' \
-d 'partner_id=apidoc' \
-d 'session=0dd42772-349a-4006-b33e-bb2833893896' \
-d 'sign=C58C5B1935721A70D9FDC0BAD72A6B5A' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-15+14%3A16%3A02' \
-d 'v=2.0' \
-d 'booth_id=12345' \
-d 'item_id=12345'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TmallNrtItemGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.booth_id=12345
req.item_id=12345
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"tmall.nrt.item.get");
add_param(pRequest,"booth_id","12345");
add_param(pRequest,"item_id","12345");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('tmall.nrt.item.get', {
	'booth_id':'12345',
	'item_id':'12345'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tmall_nrt_item_get_response>
    <tmall_nrt_item_get>
        <data>
            <status>1</status>
            <booth_id>123</booth_id>
            <c_id>123</c_id>
            <c_props>
                <category_prop_dto>
                    <property_id>20000</property_id>
                    <property_name>品牌</property_name>
                    <value_id>1000</value_id>
                    <value_text>TATA</value_text>
                </category_prop_dto>
            </c_props>
            <create_time>2000-01-01 00:00:00</create_time>
            <dealer_code>dealer01</dealer_code>
            <desc>这是一个好商品</desc>
            <ext>
                <brand_series_id>100</brand_series_id>
                <brand_series_name>系列A</brand_series_name>
                <charge_unit>BG</charge_unit>
                <grade>1</grade>
                <label_price_type>1</label_price_type>
                <original_location>
                    <city>杭州</city>
                    <city_id>111</city_id>
                    <prov>浙江</prov>
                    <prov_id>111</prov_id>
                    <type>1</type>
                </original_location>
                <price_type>1</price_type>
                <pricer>测试</pricer>
                <secondary_steel>123</secondary_steel>
                <specification>123</specification>
                <specification_unit>kg</specification_unit>
                <substrate>123</substrate>
                <support_return_goods>true</support_return_goods>
                <veneer>124</veneer>
            </ext>
            <features>{&quot;aaaa&quot;:&quot;bb&quot;}</features>
            <item_id>123</item_id>
            <images>
                <item_image_dto>
                    <position>1</position>
                    <url>xxxx.jpg</url>
                </item_image_dto>
            </images>
            <item_type>1</item_type>
            <main_item_id>111</main_item_id>
            <mall_id>1111</mall_id>
            <outer_id>123123</outer_id>
            <price>99.99</price>
            <quantity>99</quantity>
            <skus>
                <sku_dto>
                    <barcode>12312312</barcode>
                    <create_time>2000-01-01 00:00:00</create_time>
                    <outer_id>12312313</outer_id>
                    <price>99.99</price>
                    <properties>
                        <category_prop_dto>
                            <property_id>123131</property_id>
                            <property_name>颜色</property_name>
                            <value_id>213123</value_id>
                            <value_text>白色</value_text>
                        </category_prop_dto>
                    </properties>
                    <quantity>99</quantity>
                    <sku_id>12312312</sku_id>
                    <update_time>2000-01-01 00:00:00</update_time>
                </sku_dto>
            </skus>
            <title>衣柜</title>
            <update_time>2000-01-01 00:00:00</update_time>
        </data>
        <err_code>sys_err</err_code>
        <err_msg>系统错误</err_msg>
        <success>true</success>
    </tmall_nrt_item_get>
</tmall_nrt_item_get_response>

{
    "tmall_nrt_item_get_response":{
        "tmall_nrt_item_get":{
            "data":{
                "status":1,
                "booth_id":"123",
                "c_id":123,
                "c_props":{
                    "category_prop_dto":[
                        {
                            "property_id":20000,
                            "property_name":"品牌",
                            "value_id":1000,
                            "value_text":"TATA"
                        }
                    ]
                },
                "create_time":"2000-01-01 00:00:00",
                "dealer_code":"dealer01",
                "desc":"这是一个好商品",
                "ext":{
                    "brand_series_id":"100",
                    "brand_series_name":"系列A",
                    "charge_unit":"BG",
                    "grade":1,
                    "label_price_type":1,
                    "original_location":{
                        "city":"杭州",
                        "city_id":111,
                        "prov":"浙江",
                        "prov_id":111,
                        "type":1
                    },
                    "price_type":1,
                    "pricer":"测试",
                    "secondary_steel":"123",
                    "specification":"123",
                    "specification_unit":"kg",
                    "substrate":"123",
                    "support_return_goods":true,
                    "veneer":"124"
                },
                "features":"{\"aaaa\":\"bb\"}",
                "item_id":123,
                "images":{
                    "item_image_dto":[
                        {
                            "position":1,
                            "url":"xxxx.jpg"
                        }
                    ]
                },
                "item_type":1,
                "main_item_id":111,
                "mall_id":"1111",
                "outer_id":"123123",
                "price":"99.99",
                "quantity":99,
                "skus":{
                    "sku_dto":[
                        {
                            "barcode":"12312312",
                            "create_time":"2000-01-01 00:00:00",
                            "outer_id":"12312313",
                            "price":"99.99",
                            "properties":{
                                "category_prop_dto":[
                                    {
                                        "property_id":123131,
                                        "property_name":"颜色",
                                        "value_id":213123,
                                        "value_text":"白色"
                                    }
                                ]
                            },
                            "quantity":99,
                            "sku_id":12312312,
                            "update_time":"2000-01-01 00:00:00"
                        }
                    ]
                },
                "title":"衣柜",
                "update_time":"2000-01-01 00:00:00"
            },
            "err_code":"sys_err",
            "err_msg":"系统错误",
            "success":true
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
NO_PERMISSION	无权限访问	正常拦截，无需处理
-1	业务异常错误	无需处理

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

开放平台

零售终端API

tmall.nrt.item.get (家装新零售商品信息查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ