UDN-企业互联网技术人气社区

板块导航

浏览  : 47
回复  : 0

[案例与成果分享] java免费对接快递鸟快递单号查询api接口案例

[复制链接]
uec_wSbJTjJ0rb的头像 楼主
发表于 2019-8-8 11:20:25 | 显示全部楼层 |阅读模式

快递查询API接口是使用的物流单号即可实现查询物流信息。主要应用在电商商城、ERP系统商、WMS系统商、快递柜、银行等企业。多家快递物流公司接口统一接入,建议对接接口提供商,一次性可以接入多家快递,在后期的技术维护也会省下很多工作。

目前快递查询API接口有两种实现方式,一种是主动查询,一种是订阅接口推送数据。以快递鸟接口为例(接口对接需要接口秘钥,这里用的是测试的,不能够正式使用,可以到快递鸟官网申请,是免费申请秘钥的)最后附有一个的demo,更多demo可登陆快递鸟网站查询。

一.主动查询(即时查询API)
1)接口规则
a、查询接口支持按照运单号查询(单个查询,并发不超过10个/S)。
b、指定的物流运单号选择相应的快递公司编码,格式不对或则编码错误都会返失败的信息。如圆通快递物流单号应选择圆通快递公司编码(YTO)
c、返回的物流跟踪信息按照发生的时间升序排列。
d、接口指令1002。
e、请求地址:快递鸟注册

2)系统级和应用级输入参数系统级输入参数

中1.png

3)返回结果参数

中2.png

4)JSON请求示例

  1. {
  2. “OrderCode”: “”,
  3. “ShipperCode”: “SF”,
  4. “LogisticCode”: “118650888018”
  5. }
  6. // "YTO"为圆通快递公司编码,其他编码可在快递鸟官网下载
  7. 5)JSON返回示例
  8. //没有物流轨迹的
  9. {
  10. “EBusinessID”: “1109259”,
  11. "Traces":[],
  12. “OrderCode”: “”,
  13. “ShipperCode”: “SF”,
  14. “LogisticCode”: “118461988807”,
  15. “Success”: true,
  16. “Reason”: null
  17. }
  18. //有物流轨迹的
  19. {
  20. “EBusinessID”: “1109259”,
  21. "OrderCode":"",
  22. “ShipperCode”: “SF”,
  23. “LogisticCode”: “118461988807”,
  24. “Success”: true,
  25. "CallBack":"",
  26. “State”: 3,
  27. “Reason”: null,
  28. "Traces":[
  29.     {
  30.        "AcceptTime": "2014/06/25 08:05:37",
  31.        "AcceptStation": "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]",
  32.        "Remark": null
  33.     },
  34.     {
  35.        "AcceptTime": "2014/06/25 04:01:28",
  36.        "AcceptStation": "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]",
  37.        "Remark": null
  38.     },
  39.     {
  40.        "AcceptTime": "2014/06/2501:41:06",
  41.        "AcceptStation": "快件在 深圳集散中心 [深圳市]",
  42.        "Remark": null
  43.     },
  44.     {
  45.        "AcceptTime": "2014/06/24 20:18:58",
  46.        "AcceptStation": "已收件[深圳市]",
  47.        "Remark": null
  48.    },
  49.     {
  50.        "AcceptTime": "2014/06/24 20:55:28",
  51.        "AcceptStation": "快件在 深圳 ,准备送往下一站 深圳集散中心 [深圳市]",
  52.        "Remark": null
  53.     },
  54.     {
  55.        "AcceptTime": "2014/06/25 10:23:03",
  56.       "AcceptStation": "派件已签收[深圳市]",
  57.        "Remark": null
  58.     },
  59.     {
  60.        "AcceptTime": "2014/06/25 10:23:03",
  61.        "AcceptStation": "签收人是:已签收[深圳市]",
  62.        "Remark": null
  63.     }
  64. ]
复制代码

二.订阅接口推送数据(物流跟踪API)

订阅查询接口是定制化服务,用户可将订单信息订阅给快递公司,快递公司更新轨迹后,将实时转换成标准接口形式,推送给用户,起到实时推送的作用,提高效率。

同时用户订阅的数据还能选择是否通知快递员上门,实现在线下单功能。另外,快递鸟还有在途监控、电子面单等其他的接口方案,可以根据公司需求来选择。

1)接口规则

a、订单接收的信息(分给了的网点,业务员的信息),会通过推送接口推给客户(订阅并发不超过30次/S)客户需要按要求实现接口。

b、仅支持Json格式。

c、请求指令1008。

d、测试接口地址:

e、联调通过后请更换为正式地址:

f、分发及订阅接口需要客户方实现回调接口,回调RequestType(1008)

2)系统级和应用级参数


物流跟踪APIdemo

import java.io.BufferedReader;import java.io.IOException;

import java.io.InputStreamReader;

import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingException;

import java.net.HttpURLConnection;import java.net.URL;import java.net.URLEncoder;

import java.util.HashMap;import java.util.Map;import java.security.MessageDigest;

/*快递鸟订阅推送

2.0接口ID和Key请到官网申请:快递单号查询接口

  1. //DEMO
  2. public static void main(String[] args) {
  3.     KdniaoSubscribeAPI api = new KdniaoSubscribeAPI();
  4.     try {
  5.         String result = api.orderTracesSubByJson();
  6.         System.out.print(result);
  7.         
  8.     } catch (Exception e) {
  9.         e.printStackTrace();
  10.     }
  11. }

  12. //电商ID
  13. private String EBusinessID="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx";
  14. //电商加密私钥,快递鸟提供,注意保管,不要泄漏
  15. private String AppKey="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx";
  16. //测试请求url
  17. private String ReqURL = "http://testapi.kdniao.cc:8081/api/dist";
  18. //正式请求url
  19. //private String ReqURL = "http://api.kdniao.cc/api/dist";

  20. /**
  21. * Json方式  物流信息订阅
  22. * @throws Exception
  23. */
  24. public String orderTracesSubByJson() throws Exception{
  25.     String requestData="{'OrderCode': 'SF201608081055208281'," +
  26.                             "'ShipperCode':'SF'," +
  27.                             "'LogisticCode':'3100707578976'," +
  28.                             "'PayType':1," +
  29.                             "'ExpType':1," +
  30.                             "'CustomerName':'',"+
  31.                             "'CustomerPwd':''," +
  32.                             "'MonthCode':''," +
  33.                             "'IsNotice':0," +
  34.                             "'Cost':1.0," +
  35.                             "'OtherCost':1.0," +
  36.                             "'Sender':" +
  37.                             "{" +
  38.                             "'Company':'LV','Name':'Taylor','Mobile':'15018442396','ProvinceName':'上海','CityName':'上海','ExpAreaName':'青浦区','Address':'明珠路73号'}," +
  39.                             "'Receiver':" +
  40.                             "{" +
  41.                             "'Company':'GCCUI','Name':'Yann','Mobile':'15018442396','ProvinceName':'北京','CityName':'北京','ExpAreaName':'朝阳区','Address':'三里屯街道雅秀大厦'}," +
  42.                             "'Commodity':" +
  43.                             "[{" +
  44.                             "'GoodsName':'鞋子','Goodsquantity':1,'GoodsWeight':1.0}]," +
  45.                             "'Weight':1.0," +
  46.                             "'Quantity':1," +
  47.                             "'Volume':0.0," +
  48.                             "'Remark':'小心轻放'}";
  49.    
  50.     Map params = new HashMap();
  51.     params.put("RequestData", urlEncoder(requestData, "UTF-8"));
  52.     params.put("EBusinessID", EBusinessID);
  53.     params.put("RequestType", "1008");
  54.     String dataSign=encrypt(requestData, AppKey, "UTF-8");
  55.     params.put("DataSign", urlEncoder(dataSign, "UTF-8"));
  56.     params.put("DataType", "2");
  57.    
  58.     String result=sendPost(ReqURL, params);   
  59.    
  60.     //根据公司业务处理返回的信息......
  61.    
  62.     return result;
  63. }
  64.    
  65. /**
  66. * MD5加密
  67. * @param str 内容      
  68. * @param charset 编码方式
  69. * @throws Exception
  70. */
  71. @SuppressWarnings("unused")
  72. private String MD5(String str, String charset) throws Exception {
  73.     MessageDigest md = MessageDigest.getInstance("MD5");
  74.     md.update(str.getBytes(charset));
  75.     byte[] result = md.digest();
  76.     StringBuffer sb = new StringBuffer(32);
  77.     for (int i = 0; i < result.length; i++) {
  78.         int val = result[i] & 0xff;
  79.         if (val <= 0xf) {
  80.             sb.append("0");
  81.         }
  82.         sb.append(Integer.toHexString(val));
  83.     }
  84.     return sb.toString().toLowerCase();
  85. }

  86. /**
  87. * base64编码
  88. * @param str 内容      
  89. * @param charset 编码方式
  90. * @throws UnsupportedEncodingException
  91. */
  92. private String base64(String str, String charset) throws UnsupportedEncodingException{
  93.     String encoded = base64Encode(str.getBytes(charset));
  94.     return encoded;   
  95. }   

  96. @SuppressWarnings("unused")
  97. private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{
  98.     String result = URLEncoder.encode(str, charset);
  99.     return result;
  100. }

  101. /**
  102. * 电商Sign签名生成
  103. * @param content 内容   
  104. * @param keyValue Appkey  
  105. * @param charset 编码方式
  106. * @throws UnsupportedEncodingException ,Exception
  107. * @return DataSign签名
  108. */
  109. @SuppressWarnings("unused")
  110. private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception
  111. {
  112.     if (keyValue != null)
  113.     {
  114.         return base64(MD5(content + keyValue, charset), charset);
  115.     }
  116.     return base64(MD5(content, charset), charset);
  117. }

  118. /**
  119. * 向指定 URL 发送POST方法的请求     
  120. * @param url 发送请求的 URL   
  121. * @param params 请求的参数集合     
  122. * @return 远程资源的响应结果
  123. */
  124. @SuppressWarnings("unused")
  125. private String sendPost(String url, Map params) {
  126.     OutputStreamWriter out = null;
  127.     BufferedReader in = null;        
  128.     StringBuilder result = new StringBuilder();
  129.     try {
  130.         URL realUrl = new URL(url);
  131.         HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection();
  132.         // 发送POST请求必须设置如下两行
  133.         conn.setDoOutput(true);
  134.         conn.setDoInput(true);
  135.         // POST方法
  136.         conn.setRequestMethod("POST");
  137.         // 设置通用的请求属性
  138.         conn.setRequestProperty("accept", "*/*");
  139.         conn.setRequestProperty("connection", "Keep-Alive");
  140.         conn.setRequestProperty("user-agent",
  141.                 "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
  142.         conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
  143.         conn.connect();
  144.         // 获取URLConnection对象对应的输出流
  145.         out = new OutputStreamWriter(conn.getOutputStream(), "UTF-8");
  146.         // 发送请求参数            
  147.         if (params != null) {
  148.               StringBuilder param = new StringBuilder();
  149.               for (Map.Entry entry : params.entrySet()) {
  150.                   if(param.length()>0){
  151.                       param.append("&");
  152.                   }                  
  153.                   param.append(entry.getKey());
  154.                   param.append("=");
  155.                   param.append(entry.getValue());                     
  156.                   System.out.println(entry.getKey()+":"+entry.getValue());
  157.               }
  158.               System.out.println("param:"+param.toString());
  159.               out.write(param.toString());
  160.         }
  161.         // flush输出流的缓冲
  162.         out.flush();
  163.         // 定义BufferedReader输入流来读取URL的响应
  164.         in = new BufferedReader(
  165.                 new InputStreamReader(conn.getInputStream(), "UTF-8"));
  166.         String line;
  167.         while ((line = in.readLine()) != null) {
  168.             result.append(line);
  169.         }
  170.     } catch (Exception e) {            
  171.         e.printStackTrace();
  172.     }
  173.     //使用finally块来关闭输出流、输入流
  174.     finally{
  175.         try{
  176.             if(out!=null){
  177.                 out.close();
  178.             }
  179.             if(in!=null){
  180.                 in.close();
  181.             }
  182.         }
  183.         catch(IOException ex){
  184.             ex.printStackTrace();
  185.         }
  186.     }
  187.     return result.toString();
  188. }

  189. private static char[] base64EncodeChars = new char[] {
  190.         'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H',
  191.         'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P',
  192.         'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X',
  193.         'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f',
  194.         'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n',
  195.         'o', 'p', 'q', 'r', 's', 't', 'u', 'v',
  196.         'w', 'x', 'y', 'z', '0', '1', '2', '3',
  197.         '4', '5', '6', '7', '8', '9', '+', '/' };
  198.    
  199. public static String base64Encode(byte[] data) {
  200.     StringBuffer sb = new StringBuffer();
  201.     int len = data.length;
  202.     int i = 0;
  203.     int b1, b2, b3;
  204.     while (i < len) {
  205.         b1 = data[i++] & 0xff;
  206.         if (i == len)
  207.         {
  208.             sb.append(base64EncodeChars[b1 >>> 2]);
  209.             sb.append(base64EncodeChars[(b1 & 0x3) << 4]);
  210.             sb.append("==");
  211.             break;
  212.         }
  213.         b2 = data[i++] & 0xff;
  214.         if (i == len)
  215.         {
  216.             sb.append(base64EncodeChars[b1 >>> 2]);
  217.             sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);
  218.             sb.append(base64EncodeChars[(b2 & 0x0f) << 2]);
  219.             sb.append("=");
  220.             break;
  221.         }
  222.         b3 = data[i++] & 0xff;
  223.         sb.append(base64EncodeChars[b1 >>> 2]);
  224.         sb.append(base64EncodeChars[((b1 & 0x03) << 4) | ((b2 & 0xf0) >>> 4)]);
  225.         sb.append(base64EncodeChars[((b2 & 0x0f) << 2) | ((b3 & 0xc0) >>> 6)]);
  226.         sb.append(base64EncodeChars[b3 & 0x3f]);
  227.     }
  228.     return sb.toString();
  229. }
复制代码



您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

关于我们
联系我们
  • 电话:010-86393388
  • 邮件:udn@yonyou.com
  • 地址:北京市海淀区北清路68号
移动客户端下载
关注我们
  • 微信公众号:yonyouudn
  • 扫描右侧二维码关注我们
  • 专注企业互联网的技术社区
版权所有:用友网络科技股份有限公司82041 京ICP备05007539号-11 京公网网备安1101080209224 Powered by Discuz!
快速回复 返回列表 返回顶部