電商,ERP廠商可能需要物流信息接口,對運單號的物流軌跡進行跟蹤,通常有些免費的不好用,及時性要求達不到,收費的也太貴了。最近發現一個免費的API接口,及時性非常高,基本上就是實時返回。需要可以聯系QQ群 479197998
訂閱請求
發起方:本服務用戶,即貴公司
地址:http://182.61.40.226:8080/kd-server/poll
通信協議:HTTP
請求類型:POST
字符集:utf-8
請求內容:
param=body
Body格式(json):
{
"kd_code": "123456", //訂閱的快遞單號,單號的最大長度是32個字符
"kd_company": "yuantong", //訂閱的快遞公司的編碼,一律用小寫字母,見章五《快遞公司編碼》
"app_key": "*********" //授權碼,由管理員分配
}
訂閱返回
由快遞100直接通過訂閱請求的response返回。
返回格式(json):
{
"result":"true",
"returnCode":"200",
"message":"提交成功"
}
result: "true"表示成功,false表示失敗
returnCode:
200: 提交成功
701: 拒絕訂閱的快遞公司
700: 訂閱方的訂閱數據存在錯誤(如不支持的快遞公司、單號為空、單號超長等)
600: 您不是合法的訂閱者(即授權Key出錯)
500: 服務器錯誤(即快遞100的服務器出理間隙或臨時性異常,有時如果因為不按規范提交請求,比如快遞公司參數寫錯等,也會報此錯誤)
501:重復訂閱
推送請求
發起方: 快遞100
請求地址: 由管理配入系統
通信協議: HTTP
請求類型: POST
字符集: utf-8
請求內容: param=body
body格式(JSON):
{
"status": "got",
"billstatus": "polling", /*監控狀態:polling:監控中,abort:中止 */
"lastResult": {
"message": "ok", /*ok 成功獲取數據 */
"push_time": "2017/3/13 19:14:52", /*推送時間 */
"state": "3", /*快遞單當前簽收狀態,包括0在途中3已簽收 */
"status": "200",
"kd_company": "xxxx", /*快遞公司 */
"kd_code": "xxxx", /*快遞單號 */
"data": [
{
"time": "2017-02-14 15:06:21", /*時間 */
"ftime": "2017-02-14 15:06:21", /*時間*/
"context": "快件已簽收,簽收人是朋友" /*內容 */
},
{
"time": "2017-02-14 15:06:21",
"ftime": "2017-02-14 15:06:21",
"context": "快件已簽收,簽收人是朋友"
},
{
"time": "2017-02-14 09:31:42",
"ftime": "2017-02-14 09:31:42",
"context": "武昌光谷二部(15337180407)的王戰勝15717179427正在派件"
},
{
"time": "2017-02-14 08:15:43",
"ftime": "2017-02-14 08:15:43",
"context": "快件到達武昌光谷二部(15337180407),上一站是武漢(027-84639979)掃描員是02730"
},
{
"time": "2017-02-13 23:58:23",
"ftime": "2017-02-13 23:58:23",
"context": "快件由武漢(027-84639979)發往武昌光谷二部(15337180407)"
},
{
"time": "2017-02-13 11:17:54",
"ftime": "2017-02-13 11:17:54",
"context": "快件由武漢分撥中心發往武漢(027-84639979)"
},
{
"time": "2017-02-13 01:48:02",
"ftime": "2017-02-13 01:48:02",
"context": "快件由鄭州分撥中心發往武漢分撥中心"
},
{
"time": "2017-02-13 01:46:45",
"ftime": "2017-02-13 01:46:45",
"context": "快件到達鄭州分撥中心,上一站是無掃描員是劉會丹"
},
{
"time": "2017-02-12 20:52:22",
"ftime": "2017-02-12 20:52:22",
"context": "快件由洛陽(037963602588、2566,2599、2511)發往鄭州分撥中心"
},
{
"time": "2017-02-12 19:31:40",
"ftime": "2017-02-12 19:31:40",
"context": "快件由洛陽(037963602588、2566,2599、2511)發往鄭州分撥中心"
},
{
"time": "2017-02-12 19:31:39",
"ftime": "2017-02-12 19:31:39",
"context": "洛陽(037963602588、2566,2599、2511)已進行裝袋掃描"
},
{
"time": "2017-02-12 17:51:40",
"ftime": "2017-02-12 17:51:40",
"context": "洛陽(037963602588、2566,2599、2511)的駱康鞋業已收件,掃描員是司機5"
}
]
}
}
Status:status=abort,即監控結束,表示message為“40天查詢無記錄”或“40天無變化時”, 此單的生命周期已結束
當status=abort且單號三天無結果時,返回的信息如下:
{"message":"3天查詢無記錄","status":"abort","lastResult":{"message":"快遞公司參數異常:單號不存在或者已經過期","state":"0","data":[],"status":"201","com":"XXXXX","nu":"XXXXXXXX","ischeck":"0","condition":""},"billstatus":""}
