Go语言视频零基础入门到精通

admin

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

  我乐接口网
  快递鸟
  快递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":""
         }
     ]
}


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