淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
tb_order_attr_request	InsSceneTbOrderWithAttrRequest	必须			入参数
└ biz_order_id Number 必须 325435342343 外部业务单号 └ attr_name_list_str String 可选 [\"yfx\"] 属性

名称	类型	示例值	描述
result	InsSceneQueryResult	object	出参结果对象
└ biz_error_msg String order attr error 错误信息 model InsSceneTbOrderWithAttr object model └ attribute_map_json_str String {"period": "1Y"} 订单属性map，转成jsonstring是因为该接口要提供top接口，top 复杂类型支持不如string类型 └ pay_flow_id String 3453453554 支付流水号 └ biz_type Number 1100 订单类型 └ gmt_create Date 2017-12-12 12:12:12 订单创建时间 └ biz_order_id Number 43532544564 订单号 └ parent_id Number 4353424534534 父订单号 └ buyer_id Number 543444 买家ID └ seller_id Number 23423423 卖家ID └ main Boolean true 是否主订单 └ detail Boolean false 是否子订单 └ end_time Date 2017-12-12 12:12:12 确认收货时间 └ actual_total_fee Number 199 实付金额,不包含邮费 └ post_fee Number 10 邮费 └ refund_fee_in_sell Number 100 售中退款金额 └ refund_fee_after_sell Number 100 售后退款金额 └ buy_amount Number 1 购买份数 └ leaf_category String 453543 叶子类目 └ root_category String 56745 根类目 └ sku String 3425345 商品型号 └ tmall_seller Boolean false 天猫商家标识 └ auction_title String test 商品标题 └ auction_pic_url String www.ttt.com 商品图片URL └ auction_url String www.ttt.com 商品链接 └ auction_price Number 199 商品单价 └ auction_id Number 345235435 商品ID └ alipay_buyer_id String 20884353453 买家支付宝账号 └ alipay_seller_id String 2088345435 卖家支付宝账号 └ pay_status String STATUS_NOT_PAY 支付状态 └ logistics_status String STATUS_UNCONSIGNED 发货状态 └ refund_status String REFUND_WAIT_SELLER_AGREE 售中退款状态,可直接从订单上取到 └ biz_success Boolean true 是否成功 └ biz_error_code String error 错误码

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlipayInsPropertysBusinessTborderattrsRequest req = new AlipayInsPropertysBusinessTborderattrsRequest();
AlipayInsPropertysBusinessTborderattrsRequest.InsSceneTbOrderWithAttrRequest obj1 = new AlipayInsPropertysBusinessTborderattrsRequest.InsSceneTbOrderWithAttrRequest();
obj1.setBizOrderId(325435342343L);
obj1.setAttrNameListStr("[\\"yfx\\"]");
req.setTbOrderAttrRequest(obj1);
AlipayInsPropertysBusinessTborderattrsResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlipayInsPropertysBusinessTborderattrsRequest req = new AlipayInsPropertysBusinessTborderattrsRequest();
AlipayInsPropertysBusinessTborderattrsRequest.InsSceneTbOrderWithAttrRequestDomain obj1 = new AlipayInsPropertysBusinessTborderattrsRequest.InsSceneTbOrderWithAttrRequestDomain();
obj1.BizOrderId = 325435342343L;
obj1.AttrNameListStr = "[\\"yfx\\"]";
req.TbOrderAttrRequest_ = obj1;
AlipayInsPropertysBusinessTborderattrsResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlipayInsPropertysBusinessTborderattrsRequest;
$tb_order_attr_request = new InsSceneTbOrderWithAttrRequest;
$tb_order_attr_request->biz_order_id="325435342343";
$tb_order_attr_request->attr_name_list_str="[\\"yfx\\"]";
$req->setTbOrderAttrRequest(json_encode($tb_order_attr_request));
$resp = $c->execute($req);

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=alipay.ins.propertys.business.tborderattrs' \
-d 'partner_id=apidoc' \
-d 'sign=F8CD546A99C2C40A8556C68F87AF4792' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-30+20%3A34%3A15' \
-d 'v=2.0' \
-d 'tb_order_attr_request=null'

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

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

req.tb_order_attr_request=""
try:
	resp= req.getResponse()
	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,"alipay.ins.propertys.business.tborderattrs");
add_param(pRequest,"tb_order_attr_request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
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('alipay.ins.propertys.business.tborderattrs', {
	'tb_order_attr_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alipay_ins_propertys_business_tborderattrs_response>
    <result>
        <biz_error_msg>order attr error</biz_error_msg>
        <model>
            <attribute_map_json_str>{&quot;period&quot;: &quot;1Y&quot;}</attribute_map_json_str>
            <pay_flow_id>3453453554</pay_flow_id>
            <biz_type>1100</biz_type>
            <gmt_create>2017-12-12 12:12:12</gmt_create>
            <biz_order_id>43532544564</biz_order_id>
            <parent_id>4353424534534</parent_id>
            <buyer_id>543444</buyer_id>
            <seller_id>23423423</seller_id>
            <main>true</main>
            <detail>false</detail>
            <end_time>2017-12-12 12:12:12</end_time>
            <actual_total_fee>199</actual_total_fee>
            <post_fee>10</post_fee>
            <refund_fee_in_sell>100</refund_fee_in_sell>
            <refund_fee_after_sell>100</refund_fee_after_sell>
            <buy_amount>1</buy_amount>
            <leaf_category>453543</leaf_category>
            <root_category>56745</root_category>
            <sku>3425345</sku>
            <tmall_seller>false</tmall_seller>
            <auction_title>test</auction_title>
            <auction_pic_url>www.ttt.com</auction_pic_url>
            <auction_url>www.ttt.com</auction_url>
            <auction_price>199</auction_price>
            <auction_id>345235435</auction_id>
            <alipay_buyer_id>20884353453</alipay_buyer_id>
            <alipay_seller_id>2088345435</alipay_seller_id>
            <pay_status>STATUS_NOT_PAY</pay_status>
            <logistics_status>STATUS_UNCONSIGNED</logistics_status>
            <refund_status>REFUND_WAIT_SELLER_AGREE</refund_status>
        </model>
        <biz_success>true</biz_success>
        <biz_error_code>error</biz_error_code>
    </result>
</alipay_ins_propertys_business_tborderattrs_response>

{
    "alipay_ins_propertys_business_tborderattrs_response":{
        "result":{
            "biz_error_msg":"order attr error",
            "model":{
                "attribute_map_json_str":"{\"period\": \"1Y\"}",
                "pay_flow_id":"3453453554",
                "biz_type":1100,
                "gmt_create":"2017-12-12 12:12:12",
                "biz_order_id":43532544564,
                "parent_id":4353424534534,
                "buyer_id":543444,
                "seller_id":23423423,
                "main":true,
                "detail":false,
                "end_time":"2017-12-12 12:12:12",
                "actual_total_fee":199,
                "post_fee":10,
                "refund_fee_in_sell":100,
                "refund_fee_after_sell":100,
                "buy_amount":1,
                "leaf_category":"453543",
                "root_category":"56745",
                "sku":"3425345",
                "tmall_seller":false,
                "auction_title":"test",
                "auction_pic_url":"www.ttt.com",
                "auction_url":"www.ttt.com",
                "auction_price":199,
                "auction_id":345235435,
                "alipay_buyer_id":"20884353453",
                "alipay_seller_id":"2088345435",
                "pay_status":"STATUS_NOT_PAY",
                "logistics_status":"STATUS_UNCONSIGNED",
                "refund_status":"REFUND_WAIT_SELLER_AGREE"
            },
            "biz_success":true,
            "biz_error_code":"error"
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案

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

保险API

alipay.ins.propertys.business.tborderattrs (查询淘宝订单信息，包含属性值)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ