調(diào)用快遞鳥提供的快遞查詢API標(biāo)準(zhǔn)接口,快速實(shí)現(xiàn)物流軌跡查詢。這篇文章將演示如何查詢京東快運(yùn)的快遞單號(hào)。
首先,我們需要準(zhǔn)備一些必要的資源:
測試商戶ID:test1617571
測試API key:554343b2-7252-439b-b4eb-1af42c8f2175(此Key僅限測試環(huán)境使用)
API測試地址:http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
接下來,我們需要知道接口參數(shù),也就是業(yè)務(wù)參數(shù)。不同的業(yè)務(wù)接口,參數(shù)的字段和內(nèi)容都不同,會(huì)隨著業(yè)務(wù)的變化而變化。這里我們實(shí)現(xiàn)的是即時(shí)查詢接口,請(qǐng)求指令類型是1002。快遞鳥官網(wǎng)要求必須傳遞快遞公司編碼和物流單號(hào),京東快運(yùn)的編碼是JD。
若需查看其他快遞公司的編碼,可以訪問此鏈接:http://www.kdniao.com/documents
我們將使用京東快運(yùn)的真實(shí)單號(hào)(JDVD00215296905)來進(jìn)行快遞單號(hào)查詢接口的調(diào)用。
請(qǐng)求的完整報(bào)文(URL編碼以后)如下:
RequestData=%0d%0a++++++++++++%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27JD%27%2c%27LogisticCode%27%3a%27JDVD00215296905%27%2c%27CustomerName%27%3a%2712333%27%7d%0d%0a++++++++&EBusinessID=1264783&RequestType=1002&DataSign=M2QzMmVmMzUwNmNkNDFhODc2MmZmMWY5OWNkODU0NmQ%3d&DataType=2
URL解碼后的請(qǐng)求報(bào)文如下:
{'OrderCode':'','ShipperCode':'JD','LogisticCode':'JDVD00215296905','CustomerName':'12333'} &EBusinessID=1264783&RequestType=1002&DataSign=M2QzMmVmMzUwNmNkNDFhODc2MmZmMWY5OWNkODU0NmQ=&DataType=2
返回報(bào)文信息
{
"LogisticCode": "JDVD00215296905",
"ShipperCode": "JD",
"Traces": [
{
"AcceptStation": "貨物已交付京東物流",
"AcceptTime": "2019-10-07 13:47:08"
},
{
"AcceptStation": "配送員楊海濱已經(jīng)攬收完成",
"AcceptTime": "2019-10-07 13:47:08"
},
{
"AcceptStation": "受國慶假期影響,您的快遞可能會(huì)延遲配送,請(qǐng)您耐心等待;",
"AcceptTime": "2019-10-07 13:47:12"
},
{
"AcceptStation": "貨物已到達(dá)【成都樞紐中心】",
"AcceptTime": "2019-10-07 20:21:41"
},
{
"AcceptStation": "貨物已完成分揀,離開【成都樞紐中心】",
"AcceptTime": "2019-10-07 23:24:14"
},
{
"AcceptStation": "貨物已完成分揀,離開【南充中轉(zhuǎn)場】",
"AcceptTime": "2019-10-08 08:30:49"
},
{
"AcceptStation": "貨物已分配,等待配送",
"AcceptTime": "2019-10-08 08:42:27"
},
{
"AcceptStation": "配送員開始配送,請(qǐng)您準(zhǔn)備收貨,配送員,張少虎,手機(jī)號(hào),18881770240",
"AcceptTime": "2019-10-08 10:04:23"
},
{
"AcceptStation": "貨物已由本人簽收,感謝您選擇京東物流!",
"AcceptTime": "2019-10-08 15:46:50"
}
],
"State": "3",
"EBusinessID": "1264783",
"Success": true
}
通過上述步驟,我們成功地查詢了京東快運(yùn)的快遞單號(hào),并獲取了詳細(xì)的物流軌跡信息。