不限量快递查询API使用文档

1、不限量快递查询API使用文档1.1 功能说明客户通过下单、订阅接口，把运单号在快递鸟系统订阅。运单物流信息有更新，通过推送接口把更新的信息推送给客户。推送接口由用户按照接口规则实现。商户开放接口，接口定时将最新的物流轨迹推送到商户平台。优点：客户不需要关注轨迹变化，一旦有更新，自动推送。缺点：对客户的服务器性能有所要求，定时请求接口，对客户的服务器有一定的影响，客户服务器异常将接受不到最新数据。推送接口根据业务不同，会根据RequestType的分类推送不同的数据，用户需对推送的数据进行分类保存。原推送接口无需变化，快递鸟会根据推送版本进行推送。与即时查询接口（3000次/天）的区别：1、接入

2、方式不一样 即时查询接口，根据快递单号和快递公司编码实时查询物流轨迹信息 订阅推送接口，用户订阅快递号，快递鸟系统会定时推送新的物流信息2、实现的功能不一样订阅推送会持续推送更新的轨迹信息3、查询单量不一样即时查询每日查询次数3000次，订阅推送不限制订阅单量，并可一直获得每个单号的更新信息。1.2 接口规则 (1)、客户服务器必须稳定，并且有一定的接受数据能力。通过多线程推送物流信息给客户。 (2)、客户需要按快递鸟要求开发接口，保证信息的正常接收。客户接数据后，存储并马上返回接收响应。如果客户对数据进行处理，再做出响应。这会造成网络超时，传输效率低下。 (3)、主动推送时物流信息接收接口由

3、客户提供，接口必须按照快递鸟的要求实现。 (4)、客户提供接口地址，请联系快递鸟技术人员，联系方式请求查看文档尾页。(5)、接口只支持Json数据格式。(6)、接口平台：快递鸟(7)、POS方式请求。1.3 系统级输入参数参数名称类型必须要求说明RequestDataStringR推送数据经url转码utf-8 RequestTypeStringR101-轨迹查询结果, 107-货款状态1.4 应用级输入参数参数名称类型必须要求说明EBusinessIDStringR用户电商IDPushTimeStringR推送时间CountStringR推送物流单号轨迹个数DataStringR推送物流单号

4、轨迹集合1.4.1 订阅查询结果（RequestType：101）通过轨迹查询（订阅查询）接口订阅到快递鸟的数据，快递鸟推送时，会将推送的RequestType的值置为101，同时返回下列数据参数名称类型必须要求说明ResponseEBusinessIDStringO电商用户IDOrderCodeStringO订单编号ShipperCodeStringR快递公司编码LogisticCodeStringR物流运单号SuccessBoolR成功与否ReasonStringO失败原因StateStringR物流状态:0-无轨迹1-已揽收2-在途中201-到达派件城市3-签收4-问题件CallBack

5、StringO订阅接口的Bk值TracesStringR物流轨迹详情EstimatedDeliveryTimeStringO预计到达时间yyyy-mm-ddPickerInfoObjectO收件员信息SenderInfoObjectO派件员信息注：通过订单分发与电子面单接口自动订阅的运单，会返回预计达到时间,收派件人员网点信息,当前快件所在省市等字段参数名称类型必须要求说明TracesAcceptTimeStringR时间AcceptStationStringR描述RemarkStringO备注参数名称类型必须要求说明PickerInfoPersonNameStringO快递员姓名Person

6、TelStringO快递员电话PersonCodeStringO快递员工号StationNameStringO网点名称StationAddressStringO网点地址StationTelStringO网点电话参数名称类型必须要求说明SenderInfoPersonNameStringO派件快递员姓名PersonTelStringO派件快递员电话PersonCodeStringO派件快递员工号StationNameStringO派件网点名称StationAddressStringO派件网点地址StationTelStringO派件网点电话1.4.2 货款状态（RequestType：107）用

7、户通过电子面单使用快递鸟货到付款等金融服务时，快递鸟会将该订单的金融状态通过接口推送给用户。参数名称类型必须要求说明ResponseEBusinessIDStringO电商用户IDOrderCodeStringO订单编号ShipperCodeStringR快递公司编码LogisticCodeStringR物流运单号SuccessBoolR成功与否ReasonStringO失败原因StateStringR物流状态:0-无轨迹1-已揽收2-在途中201-到达派件城市3-签收4-问题件CallBackStringO订阅接口的Bk值OrderStateStringO订单货款状态：1-待出款；2-已出款

8、；3-已收款AccountNameStringO返款银行卡开户人（例：*伟、*佳）AccountTelStringO返款银行卡手机末四位AccountNumStringO返款银行卡末四位注：通过订单分发与电子面单接口自动订阅的运单，会返回预计达到时间,收派件人员网点信息,当前快件所在省市等字段1.5 返回结果参数参数名称类型必须要求说明EBusinessIDStringR用户IDUpdateTimeStringR时间SuccessStringR成功与否ReasonStringO失败原因1.6 JSON请求示例订阅查询结果示例： EBusinessID: 1109259, Count: 2, P

9、ushTime: 2015-03-11 16:21:06, Data: EBusinessID: 1109259, OrderCode: , ShipperCode: EMS, LogisticCode: 5042260908504, Success: true, Reason: , State: 2, CallBack: 0, Traces: AcceptTime: 2015-03-06 21:16:58, AcceptStation: 深圳市横岗速递营销部已收件，（揽投员姓名：钟定基;联系电话：）, Remark: , AcceptTime: 2015-03-07 14:25:00, Ac

10、ceptStation: 离开深圳市 发往广州市, Remark: , AcceptTime: 2015-03-08 00:17:00, AcceptStation: 到达广东速递物流公司广航中心处理中心（经转）, Remark: , AcceptTime: 2015-03-08 01:15:00, AcceptStation: 离开广州市 发往北京市（经转）, Remark: , AcceptTime: 2015-03-09 09:01:00, AcceptStation: 到达北京黄村转运站处理中心（经转）, Remark: , AcceptTime: 2015-03-09 18:39:0

11、0, AcceptStation: 离开北京市 发往呼和浩特市（经转）, Remark: , AcceptTime: 2015-03-10 18:06:00, AcceptStation: 到达 呼和浩特市 处理中心, Remark: , AcceptTime: 2015-03-11 09:53:48, AcceptStation: 呼和浩特市邮政速递物流分公司金川揽投部安排投递（投递员姓名：安长虹;联系电话, Remark: , EBusinessID: 1109259, OrderCode: , ShipperCode: EMS, LogisticCode: 50

12、42260943004, Success: true, Reason: , State: 2, CallBack: 0, Traces: AcceptTime: 2015-03-07 15:26:09, AcceptStation: 深圳市横岗速递营销部已收件，（揽投员姓名：周宏彪;联系电话, Remark: , AcceptTime: 2015-03-08 16:32:00, AcceptStation: 离开深圳市 发往广州市, Remark: , AcceptTime: 2015-03-09 00:58:00, AcceptStation: 到达广东速递物流公司

13、广航中心处理中心（经转）, Remark: , AcceptTime: 2015-03-09 01:15:00, AcceptStation: 离开广州市 发往北京市（经转）, Remark: , AcceptTime: 2015-03-10 05:20:00, AcceptStation: 到达北京黄村转运站处理中心（经转）, Remark: , AcceptTime: 2015-03-10 11:59:00, AcceptStation: 离开北京市 发往廊坊市（经转）, Remark: , AcceptTime: 2015-03-10 14:23:00, AcceptStation: 到

14、达廊坊市处理中心（经转）, Remark: , AcceptTime: 2015-03-11 08:55:00, AcceptStation: 离开廊坊市 发往保定市（经转）, Remark: 货款状态： EBusinessID: 1109259, Count: 2, PushTime: 2015/3/11 16:21:06, Data: EBusinessID: 1109259, OrderCode: , ShipperCode: EMS, LogisticCode: 5042260908504, Success: true, Reason: , State: 2, CallBack: 0,

15、 OrderState:1, AccountName:张三, AccountTel AccountNum:0321 , EBusinessID: 1109259, OrderCode: , ShipperCode: EMS, LogisticCode: 5042260908522, Success: true, Reason: , State: 2, CallBack: 0, OrderState:1, AccountName:张三, AccountTel AccountNum:0321 1.7 JSON返回示例 EBusinessID: 1

16、109259, UpdateTime: 2015-03-11 16: 26: 11, Success: true, Reason: 1.8 JAVA对接代码import java.io.BufferedReader;import java.io.IOException; import java.io.InputStreamReader;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingException;import .HttpURLConnection;import .URL;import .URLEnco

17、der;import java.util.HashMap;import java.util.Map;import ernal.impl.dv.util.Base64;import java.security.MessageDigest; public class KdGoldAPIDemo /电商IDprivate String EBusinessID=1237100;/电商加密私钥，注意保管，不要泄漏，请重新申请秘钥private String AppKey=518a73d8-1f7f-441a-b644-33e77b49d846;/

18、请求urlprivate String ReqURL=http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx; /* * Json方式 物流信息订阅 * throws Exception */public String orderTracesSubByJson() throws ExceptionString requestData=Code: SF,Item: + No: 909261024507,Bk: test,+ No: 589554393102,Bk: test,+ No: 589522101958,Bk: test,+ No:

19、 909198822942, Bk: test+ ;Map params = new HashMap();params.put(RequestData, urlEncoder(requestData, UTF-8);params.put(EBusinessID, EBusinessID);params.put(RequestType, 1005);String dataSign=encrypt(requestData, AppKey, UTF-8);params.put(DataSign, urlEncoder(dataSign, UTF-8);params.put(DataType, 2);

20、String result=sendPost(ReqURL, params);/根据公司业务处理返回的信息.return result;/* * XML方式 物流信息订阅 * throws Exception */public String orderTracesSubByXml() throws ExceptionString requestData=+SF+909261024507+test+909261024507+test+;Map params = new HashMap();params.put(RequestData, urlEncoder(requestData, UTF-8)

21、;params.put(EBusinessID, EBusinessID);params.put(RequestType, 1005);String dataSign=encrypt(requestData, AppKey, UTF-8);params.put(DataSign, urlEncoder(dataSign, UTF-8);params.put(DataType, 1);String result=sendPost(ReqURL, params);/根据公司业务处理返回的信息.return result;/* * MD5加密 * param str 内容 * param chars

22、et 编码方式 * throws Exception */SuppressWarnings(unused)private String MD5(String str, String charset) throws Exception MessageDigest md = MessageDigest.getInstance(MD5); md.update(str.getBytes(charset); byte result = md.digest(); StringBuffer sb = new StringBuffer(32); for (int i = 0; i result.length;

23、 i+) int val = resulti & 0xff; if (val = 0xf) sb.append(0); sb.append(Integer.toHexString(val); return sb.toString().toLowerCase();/* * base64编码 * param str 内容 * param charset 编码方式 * throws UnsupportedEncodingException */private String base64(String str, String charset) throws UnsupportedEncodingExc

24、eptionString encoded = Base64.encode(str.getBytes(charset);return encoded; SuppressWarnings(unused)private String urlEncoder(String str, String charset) throws UnsupportedEncodingExceptionString result = URLEncoder.encode(str, charset);return result;/* * 电商Sign签名生成 * param content 内容 * param keyValu

25、e Appkey * param charset 编码方式 * throws UnsupportedEncodingException ,Exception * return DataSign签名 */SuppressWarnings(unused)private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exceptionif (keyValue != null)return base64(MD5(content + keyValu

26、e, charset), charset);return base64(MD5(content, charset), charset); /* * 向指定 URL 发送POST方法的请求 * param url 发送请求的 URL * param params 请求的参数集合 * return 远程资源的响应结果 */SuppressWarnings(unused)private String sendPost(String url, Map params) OutputStreamWriter out = null; BufferedReader in = null; StringBuild

27、er result = new StringBuilder(); try URL realUrl = new URL(url); HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection(); / 发送POST请求必须设置如下两行 conn.setDoOutput(true); conn.setDoInput(true); / POST方法 conn.setRequestMethod(POST); / 设置通用的请求属性 conn.setRequestProperty(accept, */*); conn.setReq

28、uestProperty(connection, Keep-Alive); conn.setRequestProperty(user-agent, Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1); conn.setRequestProperty(Content-Type, application/x-www-form-urlencoded); conn.connect(); / 获取URLConnection对象对应的输出流 out = new OutputStreamWriter(conn.getOutputStream(), U

29、TF-8); / 发送请求参数 if (params != null) StringBuilder param = new StringBuilder(); for (Map.Entry 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.p

30、rintln(param:+param.toString(); out.write(param.toString(); / flush输出流的缓冲 out.flush(); / 定义BufferedReader输入流来读取URL的响应 in = new BufferedReader( new InputStreamReader(conn.getInputStream(), UTF-8); String line; while (line = in.readLine() != null) result.append(line); catch (Exception e) e.printStackT

31、race(); /使用finally块来关闭输出流、输入流 finally try if(out!=null) out.close(); if(in!=null) in.close(); catch(IOException ex) ex.printStackTrace(); return result.toString(); 1.9 PHP对接代码 EBusinessID, RequestType = 1005, RequestData = urlencode($requestData) , DataType = 2, ); $datasDataSign = encrypt($requestD

32、ata, AppKey);$result=sendPost(ReqURL, $datas);/根据公司业务处理返回的信息.return $result;/* * XML方式 物流信息订阅 */function orderTracesSubByXml()$requestData=.SF.909261024507.test.909261024507.test.;$datas = array( EBusinessID = EBusinessID, RequestType = 1005, RequestData = urlencode($requestData) , DataType = 1, );

33、$datasDataSign = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);/根据公司业务处理返回的信息.return $result;/* * post提交数据 * param string $url 请求Url * param array $datas 提交的数据 * return url响应返回的html */function sendPost($url, $datas) $temps = array(); foreach ($datas as $key = $value) $temps = sprint

34、f(%s=%s, $key, $value); $post_data = implode(&, $temps); $url_info = parse_url($url);if($url_infoport=)$url_infoport=80;echo $url_infoport; $httpheader = POST . $url_infopath . HTTP/1.0rn; $httpheader.= Host: . $url_infohost . rn; $httpheader.= Content-Type:application/x-www-form-urlencodedrn; $http

35、header.= Content-Length: . strlen($post_data) . rn; $httpheader.= Connection:closernrn; $httpheader.= $post_data; $fd = fsockopen($url_infohost, $url_infoport); fwrite($fd, $httpheader); $gets = ;$headerFlag = true;while (!feof($fd) if ($header = fgets($fd) & ($header = rn | $header = n) break; while (!feof($fd) $gets.= fread($fd, 128); fclose($fd); return $gets;/* * 电商Sign签名生成 * param data 内容 * param appkey Appkey * return DataSign签名 */function encrypt($data, $appke