此接口支持顺丰、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 |