快递查询—API接口

原文地址为： 快递查询—API接口

前言

随着网购的发展，快递业也随之壮大。快递查询接口对接的需求量也越来越大，下面是对免费快递接口做的整理，并附上调用流程，分享给大家，望沟通指教。

 

快递查询接口提供方

我乐接口网

快递鸟

快递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":""
        }
    ]
}

希望能帮助到需要快递接口对接的朋友~

转载请注明本文地址： 快递查询—API接口