使用免費快遞接口查詢物流信息


電商,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":""}


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM