此接口支持顺丰、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 | 内部服务错误 |
随时随地看视频
