淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	描述
logistics_id	String	可选	AL8234243	该订单下的物流编号
trade_source_type	String	必须	cbu-trade	交易订单来源,支持的来源有：cbu-trade
order_id	Number	必须	13342343	订单号

名称	类型	示例值	描述
result_msg	String	成功	请求返回结果信息
total_count	Number	0	订单中物流单个数
result_code	String	success	请求发货结果编码
is_success	Boolean	true	操作是否成功
trace_list	Trace []		物流单及跟踪信息列表
└ logistics_id String AL13242342 物流编号 └ order_id Number 1342424 交易订单号 └ logistics_bill_no String 223422143 物流公司提供的运单号 logistics_steps LogisticsStep [] 流转信息列表 └ accept_time String 2000-01-01 00:00:00 状态发生的时间 └ remark String 达到杭州物流集中地状态描述 trace_node_list TraceNode [] 物流节点信息列表 └ accept_time String 2012-04-13 09:38:00 流转节点的时间格式 yyyy-MM-dd HH:mm:ss └ encrypt String GB 地区编码规范（CN、GB） └ area_code String 3111111 事件发生城市的省市区编码 └ action String SIGN 事件/操作，事件包括：TRANSPORT，SIGN，UNSIGN └ facility_name String 滨东路网点网点名称或分拨中心名称 └ facility_no String 234 网点编号 └ facility_type String 网点站点类型：1. 网点，2. 中转中心\分拨中心 └ remark String 到达杭州集散中心状态描述

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaOpenLogisticsTraceGetRequest req = new AlibabaOpenLogisticsTraceGetRequest();
req.setLogisticsId("AL8234243");
req.setTradeSourceType("cbu-trade");
req.setOrderId(13342343L);
AlibabaOpenLogisticsTraceGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

<alibaba_open_logistics_trace_get_response>
    <result_msg>成功</result_msg>
    <total_count>0</total_count>
    <result_code>success</result_code>
    <is_success>true</is_success>
    <trace_list>
        <trace>
            <logistics_id>AL13242342</logistics_id>
            <order_id>1342424</order_id>
            <logistics_bill_no>223422143</logistics_bill_no>
            <logistics_steps>
                <logistics_step>
                    <accept_time>2000-01-01 00:00:00</accept_time>
                    <remark>达到杭州物流集中地</remark>
                </logistics_step>
            </logistics_steps>
            <trace_node_list>
                <trace_node>
                    <accept_time>2012-04-13 09:38:00</accept_time>
                    <encrypt>GB</encrypt>
                    <area_code>3111111</area_code>
                    <action>SIGN</action>
                    <facility_name>滨东路网点</facility_name>
                    <facility_no>234</facility_no>
                    <facility_type>网点</facility_type>
                    <remark>到达杭州集散中心</remark>
                </trace_node>
            </trace_node_list>
        </trace>
    </trace_list>
</alibaba_open_logistics_trace_get_response>

{
    "alibaba_open_logistics_trace_get_response":{
        "result_msg":"成功",
        "total_count":0,
        "result_code":"success",
        "is_success":true,
        "trace_list":{
            "trace":[
                {
                    "logistics_id":"AL13242342",
                    "order_id":1342424,
                    "logistics_bill_no":"223422143",
                    "logistics_steps":{
                        "logistics_step":[
                            {
                                "accept_time":"2000-01-01 00:00:00",
                                "remark":"达到杭州物流集中地"
                            }
                        ]
                    },
                    "trace_node_list":{
                        "trace_node":[
                            {
                                "accept_time":"2012-04-13 09:38:00",
                                "encrypt":"GB",
                                "area_code":"3111111",
                                "action":"SIGN",
                                "facility_name":"滨东路网点",
                                "facility_no":"234",
                                "facility_type":"网点",
                                "remark":"到达杭州集散中心"
                            }
                        ]
                    }
                }
            ]
        }
    }
}

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

1688物流

alibaba.open.logistics.trace.get (物流流转信息查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ