简单快递查询接口API/插件开发使用

快递接口/插件是电商网站和系统商用来实现查询快递功能的主要方法，就类似淘宝京东查询物流轨迹一样，嵌入到自己系统里。

现在有好几家公司都提供集成的接口，就是对接或嵌入一次，就能查询多家快递公司信息。比较实惠常用的是快递鸟的接口，以下对接嵌入方法以他为例。

方法区别

接口对接：对接周期1~3天，需要开发，不限查询次数

插件嵌入：对接周期1天，基本不需要开发，每天只能查询3000次，如果查询量比较大，建议还是接口对接，还能对数据做存储和分析

一.接口对接

接口在对接前需要到快递鸟官网注册账号，免费注册的，注册后登录查看自己的接口ID和KEY，用于

对接的EBusinessID和APPKEY两个参数赋值。

接口规则：订单接收的信息(分给了的网点，业务员的信息)，会通过推送接口推给客户（订阅并发不超过30次/S）客户需要按要求实现接口；仅支持Json格式；请求指令1008；测试接口地址：:8081/api/dist；联调通过后请更换为正式地址：/api/dist；分发及订阅接口需要客户方实现回调接口，回调RequestType(1008)

系统级和应用级输入参数

demo

importjava.io.BufferedReader;importjava.io.IOException;importjava.io.InputStreamReader;importjava.io.OutputStreamWriter;importjava.io.UnsupportedEncodingException;.HttpURLConnection;.URL;.URLEncoder;importjava.util.HashMap;importjava.util.Map;importjava.security.MessageDigest;/****快递鸟订阅推送2.0接口**ID和Key请到官网申请：/ServiceApply.aspx*/publicclassKdniaoSubscribeAPI{//DEMOpublicstaticvoidmain(String[]args){KdniaoSubscribeAPIapi=newKdniaoSubscribeAPI();try{Stringresult=api.orderTracesSubByJson();System.out.print(result);}catch(Exceptione){e.printStackTrace();}}//电商IDprivateStringEBusinessID="请到快递鸟官网申请/ServiceApply.aspx";//电商加密私钥，快递鸟提供，注意保管，不要泄漏privateStringAppKey="请到快递鸟官网申请/ServiceApply.aspx";//测试请求urlprivateStringReqURL=":8081/api/dist";//正式请求url//privateStringReqURL="/api/dist";/***Json方式物流信息订阅*@throwsException*/publicStringorderTracesSubByJson()throwsException{StringrequestData="{'OrderCode':'SF08081055208281',"+"'ShipperCode':'SF',"+"'LogisticCode':'3100707578976',"+"'PayType':1,"+"'ExpType':1,"+"'CustomerName':'',"+"'CustomerPwd':'',"+"'MonthCode':'',"+"'IsNotice':0,"+"'Cost':1.0,"+"'OtherCost':1.0,"+"'Sender':"+"{"+"'Company':'LV','Name':'Taylor','Mobile':'15018442396','ProvinceName':'上海','CityName':'上海','ExpAreaName':'青浦区','Address':'明珠路73号'},"+"'Receiver':"+"{"+"'Company':'GCCUI','Name':'Yann','Mobile':'15018442396','ProvinceName':'北京','CityName':'北京','ExpAreaName':'朝阳区','Address':'三里屯街道雅秀大厦'},"+"'Commodity':"+"[{"+"'GoodsName':'鞋子','Goodsquantity':1,'GoodsWeight':1.0}],"+"'Weight':1.0,"+"'Quantity':1,"+"'Volume':0.0,"+"'Remark':'小心轻放'}";Map<String,String>params=newHashMap<String,String>();params.put("RequestData",urlEncoder(requestData,"UTF-8"));params.put("EBusinessID",EBusinessID);params.put("RequestType","1008");StringdataSign=encrypt(requestData,AppKey,"UTF-8");params.put("DataSign",urlEncoder(dataSign,"UTF-8"));params.put("DataType","2");Stringresult=sendPost(ReqURL,params);//根据公司业务处理返回的信息......returnresult;}/***MD5加密*@paramstr内容*@paramcharset编码方式*@throwsException*/@SuppressWarnings("unused")privateStringMD5(Stringstr,Stringcharset)throwsException{MessageDigestmd=MessageDigest.getInstance("MD5");md.update(str.getBytes(charset));byte[]result=md.digest();StringBuffersb=newStringBuffer(32);for(inti=0;i<result.length;i++){intval=result[i]&0xff;if(val<=0xf){sb.append("0");}sb.append(Integer.toHexString(val));}returnsb.toString().toLowerCase();}/***base64编码*@paramstr内容*@paramcharset编码方式*@throwsUnsupportedEncodingException*/privateStringbase64(Stringstr,Stringcharset)throwsUnsupportedEncodingException{Stringencoded=base64Encode(str.getBytes(charset));returnencoded;}@SuppressWarnings("unused")privateStringurlEncoder(Stringstr,Stringcharset)throwsUnsupportedEncodingException{Stringresult=URLEncoder.encode(str,charset);returnresult;}/***电商Sign签名生成*@paramcontent内容*@paramkeyValueAppkey*@paramcharset编码方式*@throwsUnsupportedEncodingException,Exception*@returnDataSign签名*/@SuppressWarnings("unused")privateStringencrypt(Stringcontent,StringkeyValue,Stringcharset)throwsUnsupportedEncodingException,Exception{if(keyValue!=null){returnbase64(MD5(content+keyValue,charset),charset);}returnbase64(MD5(content,charset),charset);}/***向指定URL发送POST方法的请求*@paramurl发送请求的URL*@paramparams请求的参数集合*@return远程资源的响应结果*/@SuppressWarnings("unused")privateStringsendPost(Stringurl,Map<String,String>params){OutputStreamWriterout=null;BufferedReaderin=null;StringBuilderresult=newStringBuilder();try{URLrealUrl=newURL(url);HttpURLConnectionconn=(HttpURLConnection)realUrl.openConnection();//发送POST请求必须设置如下两行conn.setDoOutput(true);conn.setDoInput(true);//POST方法conn.setRequestMethod("POST");//设置通用的请求属性conn.setRequestProperty("accept","*/*");conn.setRequestProperty("connection","Keep-Alive");conn.setRequestProperty("user-agent","Mozilla/4.0(compatible;MSIE6.0;WindowsNT5.1;SV1)");conn.setRequestProperty("Content-Type","application/x-www-form-urlencoded");conn.connect();//获取URLConnection对象对应的输出流out=newOutputStreamWriter(conn.getOutputStream(),"UTF-8");//发送请求参数if(params!=null){StringBuilderparam=newStringBuilder();for(Map.Entry<String,String>entry:params.entrySet()){if(param.length()>0){param.append("&");}param.append(entry.getKey());param.append("=");param.append(entry.getValue());System.out.println(entry.getKey()+":"+entry.getValue());}System.out.println("param:"+param.toString());out.write(param.toString());}//flush输出流的缓冲out.flush();//定义BufferedReader输入流来读取URL的响应in=newBufferedReader(newInputStreamReader(conn.getInputStream(),"UTF-8"));Stringline;while((line=in.readLine())!=null){result.append(line);}}catch(Exceptione){e.printStackTrace();}//使用finally块来关闭输出流、输入流finally{try{if(out!=null){out.close();}if(in!=null){in.close();}}catch(IOExceptionex){ex.printStackTrace();}}returnresult.toString();}privatestaticchar[]base64EncodeChars=newchar[]{'A','B','C','D','E','F','G','H','I','J','K','L','M','N','O','P','Q','R','S','T','U','V','W','X','Y','Z','a','b','c','d','e','f','g','h','i','j','k','l','m','n','o','p','q','r','s','t','u','v','w','x','y','z','0','1','2','3','4','5','6','7','8','9','+','/'};publicstaticStringbase64Encode(byte[]data){StringBuffersb=newStringBuffer();intlen=data.length;inti=0;intb1,b2,b3;while(i<len){b1=data[i++]&0xff;if(i==len){sb.append(base64EncodeChars[b1>>>2]);sb.append(base64EncodeChars[(b1&0x3)<<4]);sb.append("==");break;}b2=data[i++]&0xff;if(i==len){sb.append(base64EncodeChars[b1>>>2]);sb.append(base64EncodeChars[((b1&0x03)<<4)|((b2&0xf0)>>>4)]);sb.append(base64EncodeChars[(b2&0x0f)<<2]);sb.append("=");break;}b3=data[i++]&0xff;sb.append(base64EncodeChars[b1>>>2]);sb.append(base64EncodeChars[((b1&0x03)<<4)|((b2&0xf0)>>>4)]);sb.append(base64EncodeChars[((b2&0x0f)<<2)|((b3&0xc0)>>>6)]);sb.append(base64EncodeChars[b3&0x3f]);}returnsb.toString();}}

二.插件嵌入（PC）

接口说明

（1）在项目中引入KDNWidget.js/KDNWidget.css库文件（请查看附件）。

（2）接口需要指定快递单号的快递公司编码、快递运单号、服务类型、容器的ID以及展示类型，格式不对或则编码错误都会返失败的信息。

如：中通物流单号应选择快递公司编码（ZTO）（编码可以在官网下载）

（3）返回的物流跟踪信息按照发生的时间升序排列。

请求系统级参数说明：

备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）

插件调用示例

<html><head>要引入的CSS文件：<linkrel="stylesheet"href="KDNWidget.css"></head><body>页面其它标签要引入的JS文件：<scriptsrc="KDNWidget.js"></<script><script>KDNWidget.run({serviceType:"B",expCode:"453173031799",expNo:"453173031799",showType:"normal"container:"demoID",})</script></body></html>