此接口支持順豐、EMS、申通、圓通、韻達、匯通、中通、天天、德邦、全峯等主流快遞公司
1.快遞公司列表
· 接口地址:http://api.data-ranking.com/express/company
· 支持格式:JSON
· 請求方式:GET
· 請求示例:http://api.data-ranking.com/express/company?appkey=APPKEY
請求參數:
名稱 | 類型 | 必填 | 說明 |
key | string | 是 | 應用APPKEY |
返回參數:
名稱 | 類型 | 說明 |
firms | Array | 快遞公司集合 |
firm | string | 快遞公司名稱 |
code | string | 快遞公司代碼 |
返回示例:
{ "status": 1, "msg": "api調用成功", "data": [ { "firm": "申通", "code": "shentong" }, { "firm": "EMS", "code": "ems" }, { "firm": "順豐", "code": "shunfeng" }, { "firm": "圓通", "code": "yuantong" }, { "firm": "中通", "code": "zhongtong" }, { "firm": "韻達", "code": "yunda" }, { "firm": "天天", "code": "tiantian" }, { "firm": "匯通", "code": "huitongkuaidi" }, { "firm": "全峯", "code": "quanfengkuaidi" }, { "firm": "德邦", "code": "debangwuliu" }, { "firm": "宅急送", "code": "zhaijisong" } ] } |
2.快遞單查詢
· 接口地址:http://api.data-ranking.com/express/query
· 支持格式:JSON
· 請求方式:GET
· 請求示例:http://api.data-ranking.com/express/query?firm=yuantong&no=710286471234&appkey=APPKEY
請求參數:
名稱 | 類型 | 必填 | 說明 |
firm | string | 是 | 快遞公司代號 |
no | string | 是 | 快遞單號 |
key | string | 是 | 應用APPKEY |
返回參數:
名稱 | 類型 | 說明 |
status | Int | 狀態：200成功，400參數錯誤，201快遞公司參數異常 |
message | string | 返回狀態說明 |
firm | string | 快遞公司名稱 |
no | string | 快遞單號 |
list | Array | 快遞配送進展 |
返回示例:
{ "status": 1, "msg": "api調用成功", "data": { "status": "200", "firm": "圓通", "no": "710286471234", "message": "ok", "list": [ { "time": "2016-09-03 20:19:04", "context": "廣東省東莞市大朗公司取件人: 肖勇榮已收件" }, { "time": "2016-09-03 20:58:51", "context": "廣東省東莞市大朗公司(點擊查詢電話) 已攬收" }, { "time": "2016-09-03 21:09:25", "context": "廣東省東莞市大朗公司已發出,下一站虎門轉運中心" }, ...... ] } } |
3.錯誤碼參照
系統級錯誤碼參照：
錯誤碼 | 說明 | 舊版本(resultcode) |
10001 | appkey爲空 | 101 |
10002 | appkey無請求此數據權限 | 102 |
10003 | 請求次數已經耗盡，請續費購買 | 103 |
10004 | 接口維護中 | 104 |
10005 | 接口已停用 | 105 |
10006 | 您的IP地址無調用權限 | 106 |
10007 | 您的賬戶未認證或者認證還沒有結束 | 107 |
10008 | 內部服務錯誤 | 108 |