前言
随着网购的发展,快递业也随之壮大。快递查询接口对接的需求量也越来越大,下面是对免费快递接口做的整理,并附上调用流程,分享给大家,望沟通指教。
快递查询接口提供方
我乐接口网
快递鸟
快递100
爱查快递
快递网
爱快递
对接流程
我现在在使用我乐接口网的,就以我乐接口网提供的快递查询接口对接流程为例:
1.先到其官网http://www.56jiekou.com/login.html注册并登录。
2.然后到其接口页http://www.56jiekou.com/query.html,申请获得自己的key。
3.最后到其文档下载页http://www.56jiekou.com/download.html,下载相关文档和响应SDK(目前有PHP, Java,.net)并调试。
接入实例
1、接口地址
http://www.56jiekou.com/index.php/openapi-api.html?key=xxxx&num=437889771953&exp=zhongtong
注:禁止通过 IP 访问API。
2、参数说明
名称 | 类型 | 是否必需 | 描述 |
key | String | 是 | 身份授权 Key(大小敏感) |
exp | String | 否 | 要查询的快递单号所属快递公司的简码(由数字和字母组成,详见公司简码表)。不填默认根据单号自动匹配公司。(未达100%,不建议使用自动匹配) |
num | String | 是 | 要查询的快递单号(由字母[大小不敏感]、-、数字组成的5-27位单号) |
note | Stirng | 否 | 是否返回完整的轨迹信息,0:返回完整的轨迹信息,1:只返回当前最新的一条轨迹信息。不填默认返回完整轨迹信息。 |
sort | Stirng | 否 | 轨迹信息按时间排序。desc:由当前信息到发货信息排列,asc:由发货信息到当前信息。不填默认desc(大小不敏感)。 |
3、返回结果说明
字段名称 | 字段含义 |
EBusinessID | 用户ID,暂未开放,请忽略 |
OrderCode | 订单编号,暂未开放,请忽略 |
ShipperCode | 快递公司简码 |
LogisticCode | 请求的快递单号 |
Success | 返回状态:true 成功 ,false 失败 |
Reason | 如果请求失败,失败原因(查询成功时,值为空)。 |
State | 运单的当前状态码:0 暂无结果,1 揽件,2 在途,3 派件,4 签收,5 疑难,6 退签, 7 退回 |
CallBack | 暂未开放字段,无意义,请忽略。 |
Traces | 快递轨迹信息,数组形式。 |
AcceptTime | 每条轨迹信息的时间。 |
AcceptStation | 每条轨迹信息的详情。 |
Remark | 每条轨迹的备注,暂未开放,请忽略 |
4、返回结果说明API返回结果师范
1. Json 返回示例(中文编码为 Unicode)
{"EBusinessID":"","OrderCode":"","ShipperCode":"zhongtong","LogisticCode":"437889771953","Success":true,"Reason":"","State":6,"CallBack":"","Traces":[{"AcceptTime":"2017-05-15 13:49:56","AcceptStation":"[\u957f\u6625\u5e02][\u957f\u6625\u51ef\u65cb\u8def]\u7684\u6d3e\u4ef6\u5df2\u7b7e\u6536\u611f\u8c22\u4f7f\u7528\u4e2d\u901a\u5feb\u9012,\u671f\u5f85\u518d\u6b21\u4e3a\u60a8\u670d\u52a1!","Remark":""},{"AcceptTime":"2017-05-15 09:52:02","AcceptStation":"[\u957f\u6625\u5e02]\u5feb\u4ef6\u5df2\u5230\u8fbe[\u957f\u6625\u51ef\u65cb\u8def],\u4e1a\u52a1\u5458\u9985\u997c\u54e581619736\u6b63\u5728\u7b2c1\u6b21\u6d3e\u4ef6\u7535\u8bdd:13069005179\u8bf7\u4fdd\u6301\u7535\u8bdd\u7545\u901a\u3001\u8010\u5fc3\u7b49\u5f85","Remark":""},{"AcceptTime":"2017-05-15 02:31:24","AcceptStation":"[\u957f\u6625\u5e02]\u5feb\u4ef6\u79bb\u5f00[\u957f\u6625\u4e2d\u8f6c]\u5df2\u53d1\u5f80[\u957f\u6625\u51ef\u65cb\u8def]","Remark":""},{"AcceptTime":"2017-05-15 01:41:01","AcceptStation":"[\u957f\u6625\u5e02]\u5feb\u4ef6\u5230\u8fbe[\u957f\u6625\u4e2d\u8f6c]","Remark":""},{"AcceptTime":"2017-05-13 03:48:57","AcceptStation":"[\u63ed\u9633\u5e02]\u5feb\u4ef6\u79bb\u5f00[\u6f6e\u6c55\u4e2d\u5fc3]\u5df2\u53d1\u5f80[\u957f\u6625\u4e2d\u8f6c]","Remark":""},{"AcceptTime":"2017-05-13 03:31:30","AcceptStation":"[\u63ed\u9633\u5e02]\u5feb\u4ef6\u5230\u8fbe[\u6f6e\u6c55\u4e2d\u5fc3]","Remark":""},{"AcceptTime":"2017-05-13 00:14:41","AcceptStation":"[\u63ed\u9633\u5e02]\u5feb\u4ef6\u79bb\u5f00[\u60e0\u6765\u4e2d\u901a]\u5df2\u53d1\u5f80[\u957f\u6625]","Remark":""},{"AcceptTime":"2017-05-12 23:45:39","AcceptStation":"[\u63ed\u9633\u5e02][\u60e0\u6765\u4e2d\u901a]\u7684\u5468\u539a\u8363\u5df2\u6536\u4ef6\u7535\u8bdd:","Remark":""}]}
2 Json数据解析之后的数据示例(以上面的json数据为例)
{
"EBusinessID":"",
"OrderCode":"",
"ShipperCode":"zhongtong",
"LogisticCode":"437889771953",
"Success":true,
"Reason":"",
"State":4,
"CallBack":"",
"Traces":[
{
"AcceptTime":"2017-05-15 13:49:56",
"AcceptStation":"[长春市][长春凯旋路]的派件已签收感谢使用中通快递,期待再次为您服务!",
"Remark":""
},
{
"AcceptTime":"2017-05-15 09:52:02",
"AcceptStation":"[长春市]快件已到达[长春凯旋路],业务员馅饼哥正在第1次派件电话:请保持电话畅通、耐心等待",
"Remark":""
},
{
"AcceptTime":"2017-05-15 02:31:24",
"AcceptStation":"[长春市]快件离开[长春中转]已发往[长春凯旋路]",
"Remark":""
},
{
"AcceptTime":"2017-05-15 01:41:01",
"AcceptStation":"[长春市]快件到达[长春中转]",
"Remark":""
},
{
"AcceptTime":"2017-05-13 03:48:57",
"AcceptStation":"[揭阳市]快件离开[潮汕中心]已发往[长春中转]",
"Remark":""
},
{
"AcceptTime":"2017-05-13 03:31:30",
"AcceptStation":"[揭阳市]快件到达[潮汕中心]",
"Remark":""
},
{
"AcceptTime":"2017-05-13 00:14:41",
"AcceptStation":"[揭阳市]快件离开[惠来中通]已发往[长春]",
"Remark":""
},
{
"AcceptTime":"2017-05-12 23:45:39",
"AcceptStation":"[揭阳市][惠来中通]的已收件电话:",
"Remark":""
}
]
}
希望能帮助到需要快递接口对接的朋友~