常用快递查询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 |