快遞查詢—API介面
前言
隨著網購的發展，快遞業也隨之壯大。快遞查詢介面對接的需求量也越來越大，下面是對免費快遞介面做的整理，並附上呼叫流程，分享給大家，望溝通指教。
快遞查詢介面提供方
我樂介面網
快遞鳥
快遞100
快遞網
愛快遞
對接流程
我現在在使用我樂介面網的，就以我樂介面網提供的快遞查詢介面對接流程為例：
1.先到其官網http://www.56jiekou.com/login.html註冊並登入。
2.然後到其介面頁http://www.56jiekou.com/query.html，申請獲得自己的key。
3.最後到其文件下載頁http://www.56jiekou.com/download.html，下載相關文件和響應SDK（目前有PHP，Java，.net）並除錯。
接入例項
1、介面地址
http://www.56jiekou.com/index.php/openapi-api.html?key=xxxx&num=437889771953&exp=zhongtong
注：禁止通過 IP 訪問API。
2、引數說明
|
名稱 |
型別 |
是否必需 |
描述 |
|
key |
String |
是 |
身份授權 Key（大小敏感） |
|
exp |
String |
否 |
要查詢的快遞單號所屬快遞公司的簡碼（由數字和字母組成，詳見公司簡碼錶）。不填預設根據單號自動匹配公司。(未達100%，不建議使用自動匹配) |
|
num |
String |
是 |
要查詢的快遞單號(由字母[大小不敏感]、-、數字組成的5-27位單號) |
|
note |
Stirng |
否 |
是否返回完整的軌跡資訊，0:返回完整的軌跡資訊，1:只返回當前最新的一條軌跡資訊。不填預設返回完整軌跡資訊。 |
|
sort |
Stirng |
否 |
軌跡資訊按時間排序。desc：由當前資訊到發貨資訊排列，asc：由發貨資訊到當前資訊。不填預設desc（大小不敏感）。 |
3、返回結果說明
|
欄位名稱 |
欄位含義 |
|
EBusinessID |
使用者ID，暫未開放，請忽略 |
|
OrderCode |
訂單編號，暫未開放，請忽略 |
|
ShipperCode |
快遞公司簡碼 |
|
LogisticCode |
請求的快遞單號 |
|
Success |
返回狀態：true 成功 ，false 失敗 |
|
Reason |
如果請求失敗，失敗原因（查詢成功時，值為空）。 |
|
State |
運單的當前狀態碼：0 暫無結果，1 攬件，2 在途，3 派件，4 簽收，5 疑難，6 退籤， 7 退回 |
|
CallBack |
暫未開放欄位，無意義，請忽略。 |
|
Traces |
快遞軌跡資訊，陣列形式。 |
|
AcceptTime |
每條軌跡資訊的時間。 |
|
AcceptStation |
每條軌跡資訊的詳情。 |
|
Remark |
每條軌跡的備註，暫未開放，請忽略 |
4、返回結果說明API返回結果師範
1. Json 返回示例(中文編碼為 Unicode)
{"EBusinessID":"","OrderCode":"","ShipperCode":"zhongtong","LogisticCode":"437889771953","Success":true,"Reason":"","State":6,"CallBack":"","Traces":[{"AcceptTime":"2017-05-15 13:49:56","AcceptStation":"[\u957f\u6625\u5e02][\u957f\u6625\u51ef\u65cb\u8def]\u7684\u6d3e\u4ef6\u5df2\u7b7e\u6536\u611f\u8c22\u4f7f\u7528\u4e2d\u901a\u5feb\u9012,\u671f\u5f85\u518d\u6b21\u4e3a\u60a8\u670d\u52a1!","Remark":""},{"AcceptTime":"2017-05-15 09:52:02","AcceptStation":"[\u957f\u6625\u5e02]\u5feb\u4ef6\u5df2\u5230\u8fbe[\u957f\u6625\u51ef\u65cb\u8def],\u4e1a\u52a1\u5458\u9985\u997c\u54e581619736\u6b63\u5728\u7b2c1\u6b21\u6d3e\u4ef6\u7535\u8bdd:13069005179\u8bf7\u4fdd\u6301\u7535\u8bdd\u7545\u901a\u3001\u8010\u5fc3\u7b49\u5f85","Remark":""},{"AcceptTime":"2017-05-15 02:31:24","AcceptStation":"[\u957f\u6625\u5e02]\u5feb\u4ef6\u79bb\u5f00[\u957f\u6625\u4e2d\u8f6c]\u5df2\u53d1\u5f80[\u957f\u6625\u51ef\u65cb\u8def]","Remark":""},{"AcceptTime":"2017-05-15 01:41:01","AcceptStation":"[\u957f\u6625\u5e02]\u5feb\u4ef6\u5230\u8fbe[\u957f\u6625\u4e2d\u8f6c]","Remark":""},{"AcceptTime":"2017-05-13 03:48:57","AcceptStation":"[\u63ed\u9633\u5e02]\u5feb\u4ef6\u79bb\u5f00[\u6f6e\u6c55\u4e2d\u5fc3]\u5df2\u53d1\u5f80[\u957f\u6625\u4e2d\u8f6c]","Remark":""},{"AcceptTime":"2017-05-13 03:31:30","AcceptStation":"[\u63ed\u9633\u5e02]\u5feb\u4ef6\u5230\u8fbe[\u6f6e\u6c55\u4e2d\u5fc3]","Remark":""},{"AcceptTime":"2017-05-13 00:14:41","AcceptStation":"[\u63ed\u9633\u5e02]\u5feb\u4ef6\u79bb\u5f00[\u60e0\u6765\u4e2d\u901a]\u5df2\u53d1\u5f80[\u957f\u6625]","Remark":""},{"AcceptTime":"2017-05-12 23:45:39","AcceptStation":"[\u63ed\u9633\u5e02][\u60e0\u6765\u4e2d\u901a]\u7684\u5468\u539a\u8363\u5df2\u6536\u4ef6\u7535\u8bdd:","Remark":""}]}
2 Json資料解析之後的資料示例（以上面的json資料為例）
{
"EBusinessID":"",
"OrderCode":"",
"ShipperCode":"zhongtong",
"LogisticCode":"437889771953",
"Success":true,
"Reason":"",
"State":4,
"CallBack":"",
"Traces":[
{
"AcceptTime":"2017-05-15 13:49:56",
"AcceptStation":"[長春市][長春凱旋路]的派件已簽收感謝使用中通快遞,期待再次為您服務!",
"Remark":""
},
{
"AcceptTime":"2017-05-15 09:52:02",
"AcceptStation":"[長春市]快件已到達[長春凱旋路],業務員餡餅哥正在第1次派件電話:請保持電話暢通、耐心等待",
"Remark":""
},
{
"AcceptTime":"2017-05-15 02:31:24",
"AcceptStation":"[長春市]快件離開[長春中轉]已發往[長春凱旋路]",
"Remark":""
},
{
"AcceptTime":"2017-05-15 01:41:01",
"AcceptStation":"[長春市]快件到達[長春中轉]",
"Remark":""
},
{
"AcceptTime":"2017-05-13 03:48:57",
"AcceptStation":"[揭陽市]快件離開[潮汕中心]已發往[長春中轉]",
"Remark":""
},
{
"AcceptTime":"2017-05-13 03:31:30",
"AcceptStation":"[揭陽市]快件到達[潮汕中心]",
"Remark":""
},
{
"AcceptTime":"2017-05-13 00:14:41",
"AcceptStation":"[揭陽市]快件離開[惠來中通]已發往[長春]",
"Remark":""
},
{
"AcceptTime":"2017-05-12 23:45:39",
"AcceptStation":"[揭陽市][惠來中通]的已收件電話:",
"Remark":""
}
]
}
希望能幫助到需要快遞介面對接的朋友~