常用快遞查詢API接口-基于極核資料
此接口支援順豐、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 |