淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
china_logistics_id	String	可选	LA234234CN		domestic tracking number
international_logistics_id	String	可选	LP00038357949881		international tracking number
logistics_status	String	可选	CLOSED		status of the logistics order (INIT, WAIT, PICKUP, PICKUP, WAREHOUSE, WAREHOUSE, REROUTE, WAREHOUSE, WAIT, LOGISTICS, OUT, OUT, SEND, SEND, ORDER, ORDER, CLOSED)
gmt_create_end_str	String	可选	2016-06-27 18:15:00		time in YYYY-MM-dd HH:mm:SS
page_size	Number	可选	10		page size
query_express_order	Boolean	可选	false	默认值：false	query express order
current_page	Number	可选	1		current page
order_id	Number	可选	60015640573917		trade order id
gmt_create_start_str	String	可选	2016-06-27 18:20:00		time in YYYY-MM-dd HH:mm:SS
logistics_order_id	Number	可选	12424222		logistics order id(物流单ID)
logistics_order_code	String	可选	LP00509424027010		lpNumber(物流单LP号)

名称	类型	示例值	描述
result_list	Result []		result
└ china_logistics_type String chinaLogisticsType chinaLogisticsType └ channel_code String channelCode channelCode └ logistics_status String logisticsStatus logisticsStatus └ lp_number String LP00509424027010 lpNumber(LP号) └ internationallogistics_id String UL205977796BE latest International Mail No.(最新国际运单号) └ international_logistics_type String internationalLogisticsType internationalLogisticsType └ order_id Number 0 orderId └ online_logistics_id Number 0 onlineLogisticsId logistics_fee Money logisticsFee └ cent Number 0 cent └ currency_code String CNY currencyCode └ amount String 0.0 amount logistics_service_list LogisticsServiceDto [] 物流服务列表 └ code String 物流服务编码 └ resource_code String 资源编码 └ solution_code String 解决方案code logistics_fee_list Money [] 多币种运费列表 └ cent Number 0 cent └ currency_code String CNY currencyCode └ amount String 0.0 amount └ lm_resource_code String DISTRIBUTOR_30136016 lm资源code └ original_international_logistics_id String UL205977795BE original International Mail No.(原始国际运单号)
error_desc	String	System error	error desc
is_success	Boolean	true	is success
current_page	Number	1	current page
total_page	Number	10	total page

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressLogisticsRedefiningGetonlinelogisticsinfoRequest req = new AliexpressLogisticsRedefiningGetonlinelogisticsinfoRequest();
req.setChinaLogisticsId("LA234234CN");
req.setInternationalLogisticsId("LP00038357949881");
req.setLogisticsStatus("CLOSED");
req.setGmtCreateEndStr("2016-06-27 18:15:00");
req.setPageSize(10L);
req.setQueryExpressOrder(false);
req.setCurrentPage(1L);
req.setOrderId(60015640573917L);
req.setGmtCreateStartStr("2016-06-27 18:20:00");
req.setLogisticsOrderId(12424222L);
req.setLogisticsOrderCode("LP00509424027010");
AliexpressLogisticsRedefiningGetonlinelogisticsinfoResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AliexpressLogisticsRedefiningGetonlinelogisticsinfoRequest req = new AliexpressLogisticsRedefiningGetonlinelogisticsinfoRequest();
req.ChinaLogisticsId = "LA234234CN";
req.InternationalLogisticsId = "LP00038357949881";
req.LogisticsStatus = "CLOSED";
req.GmtCreateEndStr = "2016-06-27 18:15:00";
req.PageSize = 10L;
req.QueryExpressOrder = false;
req.CurrentPage = 1L;
req.OrderId = 60015640573917L;
req.GmtCreateStartStr = "2016-06-27 18:20:00";
req.LogisticsOrderId = 12424222L;
req.LogisticsOrderCode = "LP00509424027010";
AliexpressLogisticsRedefiningGetonlinelogisticsinfoResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AliexpressLogisticsRedefiningGetonlinelogisticsinfoRequest;
$req->setChinaLogisticsId("LA234234CN");
$req->setInternationalLogisticsId("LP00038357949881");
$req->setLogisticsStatus("CLOSED");
$req->setGmtCreateEndStr("2016-06-27 18:15:00");
$req->setPageSize("10");
$req->setQueryExpressOrder("false");
$req->setCurrentPage("1");
$req->setOrderId("60015640573917");
$req->setGmtCreateStartStr("2016-06-27 18:20:00");
$req->setLogisticsOrderId("12424222");
$req->setLogisticsOrderCode("LP00509424027010");
$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=aliexpress.logistics.redefining.getonlinelogisticsinfo' \
-d 'partner_id=apidoc' \
-d 'session=cf2af978-2eec-4630-9075-7659331f4752' \
-d 'sign=3A8CFCDB22FC6ABE7CC3ED50C2E2736A' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-02-04+14%3A52%3A03' \
-d 'v=2.0' \
-d 'china_logistics_id=LA234234CN' \
-d 'current_page=1' \
-d 'gmt_create_end_str=2016-06-27+18%3A15%3A00' \
-d 'gmt_create_start_str=2016-06-27+18%3A20%3A00' \
-d 'international_logistics_id=LP00038357949881' \
-d 'logistics_order_code=LP00509424027010' \
-d 'logistics_order_id=12424222' \
-d 'logistics_status=CLOSED' \
-d 'order_id=60015640573917' \
-d 'page_size=10' \
-d 'query_express_order=false'

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

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

req.china_logistics_id="LA234234CN"
req.international_logistics_id="LP00038357949881"
req.logistics_status="CLOSED"
req.gmt_create_end_str="2016-06-27 18:15:00"
req.page_size=10
req.query_express_order=false
req.current_page=1
req.order_id=60015640573917
req.gmt_create_start_str="2016-06-27 18:20:00"
req.logistics_order_id=12424222
req.logistics_order_code="LP00509424027010"
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,"aliexpress.logistics.redefining.getonlinelogisticsinfo");
add_param(pRequest,"china_logistics_id","LA234234CN");
add_param(pRequest,"international_logistics_id","LP00038357949881");
add_param(pRequest,"logistics_status","CLOSED");
add_param(pRequest,"gmt_create_end_str","2016-06-27 18:15:00");
add_param(pRequest,"page_size","10");
add_param(pRequest,"query_express_order","false");
add_param(pRequest,"current_page","1");
add_param(pRequest,"order_id","60015640573917");
add_param(pRequest,"gmt_create_start_str","2016-06-27 18:20:00");
add_param(pRequest,"logistics_order_id","12424222");
add_param(pRequest,"logistics_order_code","LP00509424027010");
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('aliexpress.logistics.redefining.getonlinelogisticsinfo', {
	'china_logistics_id':'LA234234CN',
	'international_logistics_id':'LP00038357949881',
	'logistics_status':'CLOSED',
	'gmt_create_end_str':'2016-06-27 18:15:00',
	'page_size':'10',
	'query_express_order':'false',
	'current_page':'1',
	'order_id':'60015640573917',
	'gmt_create_start_str':'2016-06-27 18:20:00',
	'logistics_order_id':'12424222',
	'logistics_order_code':'LP00509424027010'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<aliexpress_logistics_redefining_getonlinelogisticsinfo_response>
    <result_list>
        <result>
            <china_logistics_type>chinaLogisticsType</china_logistics_type>
            <channel_code>channelCode</channel_code>
            <logistics_status>logisticsStatus</logistics_status>
            <lp_number>LP00509424027010</lp_number>
            <internationallogistics_id>UL205977796BE</internationallogistics_id>
            <international_logistics_type>internationalLogisticsType</international_logistics_type>
            <order_id>0</order_id>
            <online_logistics_id>0</online_logistics_id>
            <logistics_fee>
                <cent>0</cent>
                <currency_code>CNY</currency_code>
                <amount>0.0</amount>
            </logistics_fee>
            <logistics_service_list>
                <logistics_service_dto>
                    <code></code>
                    <resource_code></resource_code>
                </logistics_service_dto>
            </logistics_service_list>
            <solution_code></solution_code>
            <logistics_fee_list>
                <money>
                    <cent>0</cent>
                    <currency_code>CNY</currency_code>
                    <amount>0.0</amount>
                </money>
            </logistics_fee_list>
            <lm_resource_code>DISTRIBUTOR_30136016</lm_resource_code>
            <original_international_logistics_id>UL205977795BE</original_international_logistics_id>
        </result>
    </result_list>
    <error_desc>System error</error_desc>
    <is_success>true</is_success>
    <current_page>1</current_page>
    <total_page>10</total_page>
</aliexpress_logistics_redefining_getonlinelogisticsinfo_response>

{
    "aliexpress_logistics_redefining_getonlinelogisticsinfo_response":{
        "result_list":{
            "result":[
                {
                    "china_logistics_type":"chinaLogisticsType",
                    "channel_code":"channelCode",
                    "logistics_status":"logisticsStatus",
                    "lp_number":"LP00509424027010",
                    "internationallogistics_id":"UL205977796BE",
                    "international_logistics_type":"internationalLogisticsType",
                    "order_id":0,
                    "online_logistics_id":0,
                    "logistics_fee":{
                        "cent":0,
                        "currency_code":"CNY",
                        "amount":"0.0"
                    },
                    "logistics_service_list":{
                        "logistics_service_dto":[
                            {
                                "code":"",
                                "resource_code":""
                            }
                        ]
                    },
                    "solution_code":"",
                    "logistics_fee_list":{
                        "money":[
                            {
                                "cent":0,
                                "currency_code":"CNY",
                                "amount":"0.0"
                            }
                        ]
                    },
                    "lm_resource_code":"DISTRIBUTOR_30136016",
                    "original_international_logistics_id":"UL205977795BE"
                }
            ]
        },
        "error_desc":"System error",
        "is_success":true,
        "current_page":1,
        "total_page":10
    }
}

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下载

全球速卖通-物流管理

aliexpress.logistics.redefining.getonlinelogisticsinfo (获取线上发货物流订单信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ