电子面单批量打印接口简易手册快递鸟

电子面单批量打印接口手册（快递鸟）1 打印 API1.1 API 说明(1)、只支持 Json 格式。接口指令 1007。(2)、订单编号(OrderCode)不可重复提交，重复提交系统会返回具体错误代码。(3)、 接口支持：顺丰（SF） 、EMS（EMS） 、宅急送（ZJS） 、圆通（YTO） 、百世快递（HTKY） 、中通（ZTO） 、韵达（YD） 、申通（STO） 、德邦（DBL） 、优速（UC） 、京东（JD）常用 20 家快递。(4)、测试地址：http:/testapi.kdniao.cc:8081/api/eorderservice/(5)、正式地址：http:/api.kdniao.cc/api/EOrderService(6)、请求报文中不允许出现以下特殊字符： “ # 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.Map;import ernal.impl.dv.util.Base64;import java.security.MessageDigest; public class KdGoldAPIDemo /电商 IDprivate String EBusinessID=“ “;/电商加密私钥，注意保管，不要泄漏private String AppKey=“ “;/请求 url, 正式环境地址：http:/api.kdniao.cc/api/Eorderservice 测试环境地址：http:/testapi.kdniao.cc:8081/api/EOrderServiceprivate String ReqURL=“http:/testapi.kdniao.cc:8081/api/Eorderservice“;/* Json 方式 电子面单* throws Exception */public String orderOnlineByJson() throws ExceptionString requestData= “OrderCode: 012657700387,“ +“ShipperCode:SF,“ +“PayType:1,“ +“ExpType:1,“ +“Cost:1.0,“ +“OtherCost:1.0,“ +“Sender:“ +“ +“Company:LV,Name:Taylor,MobileProvinceName:上海,CityName: 上海,ExpAreaName:青浦区,Address:明珠路 73 号,“ +“Receiver:“ +“ +“Company:GCCUI,Name:Yann,MobileProvinceName:北京,CityName: 北京,ExpAreaName:朝阳区,Address:三里屯街道雅秀大厦,“ +“Commodity:“ +“ +“GoodsName:鞋子,Goodsquantity:1,GoodsWeight:1.0,“ +“Weight:1.0,“ +“Quantity:1,“ +“Volume:0.0,“ +“Remark:小心轻放,“ +“IsReturnPrintTemplate: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 result=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 result = md.digest();StringBuffer sb = new StringBuffer(32);for (int i = 0; i params) OutputStreamWriter out = null;BufferedReader in = null; StringBuilder 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.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-www-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() 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 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();return result.toString();2.2 C#对接using System;using System.Collections.Generic;using System.IO;using System.Linq;using System.Net;using System.Text;using System.Web;using System.Security.Cryptography.X509Certificates;using System.Net.Security;namespace Testpublic class KdApiEOrderDemo/电商 IDprivate string EBusinessID = “请申请 /reg“;/电商加密私钥，注意保管，不要泄漏private string AppKey = “请申请“;/请求 url/正式环境地址/ private string ReqURL = “http:/api.kdniao.cc/api/Eorderservice“;/测试环境地址private string ReqURL = “http:/testapi.kdniao.cc:8081/api/EOrderService“;/ / Json 方式 电子面单/ / public string orderTracesSubByJson()string requestData = “OrderCode: 012657700222,“ +“ShipperCode:SF,“ +“PayType:1,“ +“ExpType:1,“ +“Cost:1.0,“ +“OtherCost:1.0,“ +“Sender:“ +“ +“Company:LV,Name:Taylor,MobileProvinceName:上海,CityName:上海,ExpAreaName:青浦区,Address:明珠路 73 号,“ +“Receiver:“ +“ +“Company:GCCUI,Name:Yann,MobileProvinceName:北京,CityName:北京,ExpAreaName:朝阳区,Address:三里屯街道雅秀大厦,“ +“Commodity:“ +“ +“GoodsName:鞋子,Goodsquantity:1,GoodsWeight:1.0,“ +“Weight:1.0,“ +“Quantity:1,“ +“Volume:0.0,“ +“Remark:小心轻放,“ +“IsReturnPrintTemplate:1“;Dictionary param = new Dictionary();param.Add(“RequestData“, HttpUtility.UrlEncode(requestData, Encoding.UTF8);param.Add(“EBusinessID“, EBusinessID);param.Add(“RequestType“, “1007“);string dataSign = encrypt(requestData, AppKey, “UTF-8“);param.Add(“DataSign“, HttpUtility.UrlEncode(dataSign, Encoding.UTF8);param.Add(“DataType“, “2“);string result = sendPost(ReqURL, param);/根据公司业务处理返回的信息return result;/ / Post 方式提交数据，返回网页的源代码/ / 发送请求的 URL/ 请求的参数集合/ 远程资源的响应结果private string sendPost(string url, Dictionary param)string result = “;StringBuilder postData = new StringBuilder();if (param != null postData.Append(p.Key);postData.Append(“=“);postData.Append(p.Value);byte byteData = Encoding.GetEncoding(“UTF-8“).GetBytes(postData.ToString();tryHttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);request.ContentType = “application/x-www-form-urlencoded“;request.Referer = url;request.Accept = “*/*“;request.Timeout = 30 * 1000;request.UserAgent = “Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 2.0.50727; .NET CLR 3.0.04506.648; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729)“;request.Method = “POST“;request.ContentLength = byteData.Length;Stream stream = request.GetRequestStream();stream.Write(byteData, 0, byteData.Length);stream.Flush();stream.Close();HttpWebResponse response = (HttpWebResponse)request.GetResponse();Stream backStream = response.GetResponseStream();StreamReader sr = new StreamReader(backStream, Encoding.GetEncoding(“UTF-8“);result = sr.ReadToEnd();sr.Close();backStream.Close();response.Close();request.Abort();catch (Exception ex)result = ex.Message;return result;private bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors sslPolicyErrors)throw new NotImplementedException();/电商 Sign 签名/内容/Appkey/URL 编码 /DataSign 签名private string encrypt(String content, String keyValue, String charset)if (keyValue != null)return base64(MD5(content + keyValue, charset), charset);return base64(MD5(content, charset), charset);/ 字符串 MD5 加密/要加密的字符串/编码方式/密文private string MD5(string str, string charset)byte buffer = System.Text.Encoding.GetEncoding(charset).GetBytes(str);trySystem.Security.Cryptography.MD5CryptoServiceProvider check;check = new System.Security.Cryptography.MD5CryptoServiceProvider();byte somme = check.ComputeHash(buffer);string ret = “;foreach (byte a in somme)if (a / base64 编码/ / 内容/ 编码方式/ private string base64(String str, String charset)return Convert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str);2.3 JAVA 批量打印package cc.kdniao.api;import java.io.IOException;import java.io.PrintWriter;import java.io.UnsupportedEncodingException;import .URLEncoder;import java.security.MessageDigest;import javax.servlet.ServletException;import javax.servlet.annotation.WebServlet;import javax.servlet.http.HttpServlet;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import ernal.messaging.saaj.util.Base64;/* Servlet implementation class printOrder*/WebServlet(“/printOrder“)public class printOrder extends HttpServlet private static final long serialVersionUID = 1L;final String EBussinessID = “;/ EBusinessIDfinal String AppKey = “; / AppKeyfinal Integer IsPreview = 0; /是否预览 0-不预览 1-预览/* see HttpServlet#HttpServlet()*/public printOrder() super();/ TODO Auto-generated constructor stub/* see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)*/protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException / TODO Auto-generated method stub/response.getWriter().append(“Served at: “).append(request.getContextPath();PrintWriter print = response.getWriter();String jsonResult = “;try String ip = getIpAddress(request);jsonResult = getPrintParam(ip); catch (Exception e) /write logprint.println(jsonResult);print.flush();print.close();/* see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)*/protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException, UnsupportedEncodingException / TODO Auto-generated method stubresponse.setContentType(“);PrintWriter print = response.getWriter();String jsonResult = “;try String ip = getIpAddress(request);jsonResult = getPrintParam(ip); catch (Exception e) /wirte logprint.println(jsonResult);print.flush();print.close();/* get print order param to json string* return* * throws Exception */private String getPrintParam(String ip) throws Exception String data = “OrderCode“:“234351215333113311353“,“PortName“:“SF“,“OrderCode“:“234351215333113311354“,“PortName“:“打印机名称二“;String result = “RequestData“: “ + URLEncoder.encode(data, “UTF-8“) + “, “EBusinessID“:“ + EBussinessID + “, “DataSign“:“ + encrpy(ip + data, AppKey) + “, “IsPreview“:“+ IsPreview + “;return result;private String md5(String str, String cha