常用快递API接口方案设计

1、常用快递 API 接口方案-快递配送 - 轨迹查询 - 签收电商企业从接收订单 - 配货-打印快递单到后期的快递员收件短信通知等，都需要快递接口的接入。整理目前较为常见的接口demo如下：对接流程：快递鸟申请接口对接联调测试上线预约取件 - 在线预约寄件import java.io.BufferedReader;import java.io.IOException;import java.io.InputStreamReader;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingException;impor

2、t .HttpURLConnection;import .URL;import .URLEncoder;import java.util.HashMap;import java.util.Map;import .ernal.impl.dv.util.Base64;import java.security.MessageDigest;public class KdGoldAPIDemo / 电商 IDprivate String EBusinessID= 申请 ;/ 电商加密私钥，注意保管，不要泄漏private String AppKey=申请

3、 ;/ 测试请求 urlprivate string ReqURL = testapi.kdniao.cc:8081/api/oorderservice;/ 正式请求 url/private string ReqURL = api.kdniao.cc/api/OOrderService;* Json 方式 在线下单* throws Exception*/public String orderOnlineByJson() throws ExceptionString requestData= OrderCode: 2, +ShipperCode:YTO, +PayType:1, +ExpType

4、:1, +Cost:1.0, +OtherCost:1.0, +Sender: + Company:LV,Name:Taylor,Mobile:,ProvinceName:,CityName:,ExpAreaName:青浦区 ,Address: 明珠路 73 号, +Receiver: + +Company:GCCUI,Name:Yann,Mobile:,ProvinceName:,CityName:,E xpAreaName: 区 ,Address:三里屯街道雅秀大厦 , +Commodity: + +GoodsName: 鞋,Goodsquantity:1,GoodsWeight:1.0,

5、 +AddService: + +Name:COD,Value:1020, +Weight:1.0, +Quantity:1, +Volume:0.0, +Remark: 小心轻放 , +Commodity: + +GoodsName: 鞋子 , +Goodsquantity:1, +GoodsWeight:1.0 +Map params = new HashMap(); params.put(RequestData, urlEncoder(requestData, UTF-8); params.put(EBusinessID, EBusinessID); params.put(Request

6、Type, 1001);String dataSign=encrypt(requestData, AppKey, UTF-8);params.put(DataSign, urlEncoder(dataSign, UTF-8);params.put(DataType, 2);String result=sendPost(ReqURL, params);/ 根据公司业务处理返回的信息 return result;/* MD5 加密* param str 容* param charset 编码方式* throws Exception*/SuppressWarnings(unused)private

7、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; i+) int val = resulti & 0xff;if (val = 0xf) sb.append(0);sb.appe

8、nd(Integer.toHexString(val);return sb.toString().toLowerCase();/* base64 编码* param str 容* param charset 编码方式* throws UnsupportedEncodingException*/throwsprivate String base64(String str, String charset) UnsupportedEncodingExceptionString encoded = Base64.encode(str.getBytes(charset);return encoded;S

9、uppressWarnings(unused)throwsprivate String urlEncoder(String str, String charset) UnsupportedEncodingExceptionString result = URLEncoder.encode(str, charset);return result;* 电商 Sign 签名生成* param content容* param keyValue Appkey* param charset编码方式* throws UnsupportedEncodingException ,Exception* retur

10、n DataSign 签名*/SuppressWarnings(unused)throwsprivate String encrypt (String content, String keyValue, String charset) UnsupportedEncodingException, Exceptionif (keyValue != null)return base64(MD5(content + keyValue, charset), charset);return base64(MD5(content, charset), charset);/* 向指定 URL 发送 POST方

11、法的请求* param url 发送请求的 URL* param params 请求的参数集合* return 远程资源的响应结果*/SuppressWarnings(unused)private String sendPost(String url, Map params) OutputStreamWriter out = null;BufferedReader in = null;StringBuilder result = new StringBuilder();try URL realUrl = new URL(url);=(HttpURLConnection)HttpURLConne

12、ction connrealUrl.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; MSIE 6.0;

13、 Windows NT 5.1;SV1);conn.setRequestProperty(Content-Type,application/x-form-urlencoded);conn.connect();/获取 URLConnection 对象对应的输出流out = new OutputStreamWriter(conn.getOutputStream(), UTF-8);/ 发送请求参数if (params != null) StringBuilder param = new StringBuilder();for (Map.Entry entry : params.entrySet()

14、 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 = new

15、 BufferedReader(new InputStreamReader(conn.getInputStream(), UTF-8);String line;while (line = in.readLine() != null) result.append(line); catch (Exception e) e.printStackTrace();/ 使用 finally 块来关闭输出流、输入流finallytryif(out!=null)out.close();if(in!=null)in.close();catch(IOException ex)ex.printStackTrace(

16、);return result.toString();电子面单打印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 .URLEncoder;import java.util.HashMap;import java.util.

17、Map;import .ernal.impl.dv.util.Base64;import java.security.MessageDigest;public class KdGoldAPIDemo / 电商 IDprivate String EBusinessID= 申请 ;/ 电商加密私钥，注意保管，不要泄漏 private String AppKey= 申请 ;测试环境地址：/ 请求 url, 正式环境地址： api.kdniao.cc/api/Eorderservice testapi.kdniao.cc:8081/api/EOrder

18、Serviceprivate String ReqURL=testapi.kdniao.cc:8081/api/Eorderservice;* Json 方式 电子面单* throws Exception*/public String orderOnlineByJson() throws ExceptionString requestData= OrderCode: 7, +ShipperCode:SF, +PayType:1, +ExpType:1, +Cost:1.0, +OtherCost:1.0, +Sender: + Company:LV,Name:Taylor,Mobile:,Pr

19、ovinceName:,CityName:,Ex pAreaName: 青浦区 ,Address: 明珠路 73 号, +Receiver: + +Company:GCCUI,Name:Yann,Mobile:,ProvinceName:,CityName:,E xpAreaName: 区 ,Address: 三里屯街道雅秀大厦 , +Commodity: + +GoodsName: 鞋子 ,Goodsquantity:1,GoodsWeight:1.0, +Weight:1.0, +Quantity:1, +Volume:0.0, +Remark: 小心轻放 , +IsReturnPrint

20、Template:1;Map params = new HashMap(); params.put(RequestData, urlEncoder(requestData, UTF-8); params.put(EBusinessID, EBusinessID);params.put(RequestType, 1007);String dataSign=encrypt(requestData, AppKey, UTF-8); params.put(DataSign, urlEncoder(dataSign, UTF-8); params.put(DataType, 2);String resu

21、lt=sendPost(ReqURL, params);/ 根据公司业务处理返回的信息 return result;/* MD5 加密* param str容* param charset编码方式* throws Exception*/SuppressWarnings(unused) private String MD5(String str, String charset) throws Exception MessageDigest md = MessageDigest.getInstance(MD5); md.update(str.getBytes(charset);byte resul

22、t = md.digest();StringBuffer sb = new StringBuffer(32);for (int i = 0; i result.length; 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*/t

23、hrowsprivate String base64(String str, String charset) UnsupportedEncodingExceptionString encoded = Base64.encode(str.getBytes(charset);return encoded;SuppressWarnings(unused)throwsprivate String urlEncoder(String str, String charset) UnsupportedEncodingExceptionString result = URLEncoder.encode(str

24、, charset);return result;/*电商 Sign 签名生成* param content容* param keyValue Appkey* param charset编码方式* throws UnsupportedEncodingException ,Exception* return DataSign签名*/SuppressWarnings(unused)throwsprivate String encrypt (String content, String keyValue, String charset) UnsupportedEncodingException, E

25、xceptionif (keyValue != null)return base64(MD5(content + keyValue, 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) OutputStrea

26、mWriter out = null;BufferedReader in = null;StringBuilder result = new StringBuilder();try URL realUrl = new URL(url);=(HttpURLConnection)HttpURLConnection conn realUrl.openConnection();/ 发送 POST请求必须设置如下两行conn.setDoOutput(true);conn.setDoInput(true);/ POST方法conn.setRequestMethod(POST);/ 设置通用的请求属性con

27、n.setRequestProperty(accept, */*);conn.setRequestProperty(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-form-urlencoded);conn.connect();/获取 URLConnection 对象对应的输出流out = new OutputSt

28、reamWriter(conn.getOutputStream(), UTF-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()+:+ent

29、ry.getValue(); System.out.println(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 (E

30、xception e) e.printStackTrace();/ 使用 finally 块来关闭输出流、输入流finallytry if(out!=null) out.close(); if(in!=null) in.close(); catch(IOException ex) ex.printStackTrace();return result.toString();快递查询(小量)import java.io.BufferedReader;import java.io.IOException;import java.io.InputStreamReader;import java.io.

31、OutputStreamWriter;import java.io.UnsupportedEncodingException;import .HttpURLConnection;import .URL;import .URLEncoder;import java.security.MessageDigest;import java.util.HashMap;import java.util.Map;public class KdniaoTrackQueryAPI /DEMOpublic static void main(String args) KdniaoTrackQueryAPI api

32、= new KdniaoTrackQueryAPI();try String result = api.getOrderTracesByJson(ANE, 5);System.out.print(result); catch (Exception e) e.printStackTrace();/ 电商 IDprivate String EBusinessID=申请 ;/ 电商加密私钥，注意保管，不要泄漏private String AppKey= 申请 ;/ 请求 urlprivate String ReqURL=api.kdniao.cc/Ebusiness/EbusinessOrderHa

33、ndle.aspx;* Json 方式 查询订单物流轨迹* throws Exception*/public String getOrderTracesByJson(String expCode, String expNo) throws ExceptionString requestData= OrderCode:,ShipperCode: + expCode + ,LogisticCode: + expNo + ;Map params = new HashMap(); params.put(RequestData, urlEncoder(requestData, UTF-8); param

34、s.put(EBusinessID, EBusinessID); params.put(RequestType, 1002);String dataSign=encrypt(requestData, AppKey, UTF-8); params.put(DataSign, urlEncoder(dataSign, UTF-8); params.put(DataType, 2);String result=sendPost(ReqURL, params);/ 根据公司业务处理返回的信息 return result;/* MD5 加密* param str 容* param charset 编码方

35、式* 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; i+) int val

36、 = resulti & 0xff;if (val = 0xf) sb.append(0);sb.append(Integer.toHexString(val);return sb.toString().toLowerCase();/* base64 编码* param str 容* param charset 编码方式* throws UnsupportedEncodingException*/throwsprivate String base64(String str, String charset) UnsupportedEncodingExceptionString encoded =

37、 base64Encode(str.getBytes(charset);return encoded;SuppressWarnings(unused)private String urlEncoder(String str, String charset) UnsupportedEncodingExceptionString result = URLEncoder.encode(str, charset);return result;/*电商 Sign 签名生成* param content容* param keyValue Appkey* param charset编码方式* throws

38、UnsupportedEncodingException ,Exception* return DataSign签名*/SuppressWarnings(unused)private String encrypt (String content, String keyValue, String charset) UnsupportedEncodingException, Exceptionif (keyValue != null)return base64(MD5(content + keyValue, charset), charset);return base64(MD5(content,

39、 charset), charset);throwsthrows* 向指定 URL 发送 POST方法的请求* param url 发送请求的 URL* param params 请求的参数集合* return 远程资源的响应结果*/SuppressWarnings(unused)private String sendPost(String url, Map params) OutputStreamWriter out = null;BufferedReader in = null;StringBuilder result = new StringBuilder();try URL realU

40、rl = new URL(url);=(HttpURLConnection)HttpURLConnection conn realUrl.openConnection();/ 发送 POST请求必须设置如下两行conn.setDoOutput(true);conn.setDoInput(true);/ POST方法conn.setRequestMethod(POST);/ 设置通用的请求属性conn.setRequestProperty(accept, */*);conn.setRequestProperty(connection, Keep-Alive);conn.setRequestPro

41、perty(user-agent,Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1);conn.setRequestProperty(Content-Type,application/x-form-urlencoded);conn.connect();/获取 URLConnection 对象对应的输出流out = new OutputStreamWriter(conn.getOutputStream(), UTF-8);/发送请求参数if (params != null) StringBuilder param = new String

42、Builder();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.println(param:+param.toString();out.write(param.toString();/ flush输出流的缓冲ou

43、t.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.printStackTrace();/ 使用 finally 块来关闭输出流、输入流finallytry if(out!=null) out.close(); if(in!=n

44、ull) in.close();catch(IOException ex)ex.printStackTrace();return result.toString();private static char base64EncodeChars = new char 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

45、, 7, 8, 9, +, / ;public static String base64Encode(byte data) StringBuffer sb = new StringBuffer();int len = data.length;int i = 0;int b1, b2, b3;while (i 2);sb.append(base64EncodeChars(b1 & 0x3) 2);sb.append(base64EncodeChars(b1 & 0x03) 4);sb.append(base64EncodeChars(b2 & 0x0f) 2);sb.append(base64E

46、ncodeChars(b1& 0x03) 4);sb.append(base64EncodeChars(b2& 0x0f) 6);sb.append(base64EncodeCharsb3 & 0x3f);return sb.toString();快递查询(日查询 500)import java.io.BufferedReader;import java.io.IOException;import java.io.InputStreamReader;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingExcep

47、tion;import .HttpURLConnection;import .URL;import .URLEncoder;import java.util.HashMap;import java.util.Map;import java.security.MessageDigest;* 快递鸟订阅推送 2.0 接口* 技术 QQ: 4009633321* 技术 QQ群 : 200121393* see: .kdniao./api-subscribe* copyright: 市快金数据技术服务* ID 和 Key 请到官网申请： .kdniao./ServiceApply.aspx*/ pub

48、lic class KdniaoSubscribeAPI /DEMOpublic static void main(String args) KdniaoSubscribeAPI api = new KdniaoSubscribeAPI(); try String result = api.orderTracesSubByJson(); System.out.print(result); catch (Exception e) e.printStackTrace();/ 电商 IDprivate String EBusinessID= 申请 ;/ 电商加密私钥，注意保管，不要泄漏private

49、 String AppKey= 申请 ;/ 测试请求 urlprivate String ReqURL = testapi.kdniao.cc:8081/api/dist;/ 正式请求 url/private String ReqURL = api.kdniao.cc/api/dist;/* Json 方式 物流信息订阅* throws Exception*/public String orderTracesSubByJson() throws ExceptionString requestData=OrderCode: SF1, +ShipperCode:SF, + LogisticCode

50、:76, + PayType:1, + ExpType:1, + CustomerName:,+ CustomerPwd:, + MonthCode:, + IsNotice:0, + Cost:1.0, + OtherCost:1.0, + Sender: + +Company:LV,Name:Taylor,Mobile:,ProvinceName:,CityName:,Ex pAreaName: 青浦区 ,Address: 明珠路 73 号, +Receiver: + +Company:GCCUI,Name:Yann,Mobile:,ProvinceName:,CityName:,E xpAreaName: 区 ,Add