中通快递物流单号查询API接口免费对接案例

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

a、查询接口支持按照运单号查询(单个查询，并发不超过10个/S)。

b、指定的物流运单号选择相应的快递公司编码，格式不对或则编码错误都会返失败的信息。如中通快递物流单号应选择快递公司编码（ZTO）

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

d、接口指令1002。

e、请求地址：快递鸟

系统级输入参数

类型

应用级输入参数

必须要求

说明

RequestData

String

OrderCode

订单编号

请求内容，JSON格式,和DataType一致

ShipperCode

快递公司编码

LogisticCode

物流单号

EBusinessID

String

电商ID

RequestType

String

请求指令类型：1002

DataSign

String

数据内容签名

DataType

String

请求、返回数据类型： 2-json；

参数名称

类型

必须要求

说明

EBusinessID

String

电商用户ID

OrderCode

String

订单编号

ShipperCode

String

快递公司编码

LogisticCode

String

物流运单号

CallBack

String

用户标识

Success

Bool

成功与否

Reason

String

失败原因

State

String

物流状态: 0-无轨迹 2-在途中，3-签收,4-问题件

Traces/物流轨迹详情

AcceptTime

String

时间

AcceptStation

String

描述

Remark

String

备注

{

}
// "SF"为顺丰快递公司编码，其他编码可在快递鸟官网下载

//没有物流轨迹的

{

}

//有物流轨迹的

{

}

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

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

b、仅支持Json格式。

c、请求指令1008。

d、测试接口地址：http://testapi.kdniao.cc:8081/api/dist

e、联调通过后请更换为正式地址：http://api.kdniao.cc/api/dist

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

系统级输入参数

应用级输入参数

类型

是否必须

描述

RequestData（必填参数，请求内容，JSON格式,须和DataType一致））

CallBack

String

用户自定义回调信息

MemberID

String

会员标识(备用字段)

WareHouseID

String

仓库标识(备用字段)

CustomerName

String

电子面单客户账号

（与快递网点申请）

CustomerPwd

String

电子面单密码

SendSite

String

收件网点标识

ShipperCode

String

快递公司编码

LogisticCode

String

快递单号

OrderCode

String

订单编号

MonthCode

String

月结编码

PayType

Int

邮费支付方式:

1-现付，2-到付，3-月结，4-第三方支付

ExpType

String

快递类型：1-标准快件

Cost

Double

寄件费（运费）

OtherCost

Double

其他费用

Receiver

Company

String

收件人公司

Name

String

收件人

Tel

String

电话

Mobile

String

手机

PostCode

String

收件人邮编

ProvinceName

String

收件省（如广东省，不要缺少“省”）

CityName

String

收件市（如深圳市，不要缺少“市”）

ExpAreaName

String

收件区（如福田区，不要缺少“区”或“县”）

Address

String

收件人详细地址

Sender

Company

String

发件人公司

Name

String

发件人

Tel

String

发件人电话

Mobile

String

发件人手机

PostCode

String

发件人邮编

ProvinceName

String

发件省（如广东省，不要缺少“省”）

CityName

String

发件市（如深圳市，不要缺少“市”）

ExpAreaName

String

发件区（如福田区，不要缺少“区”或“县”）

Address

String

发件详细地址

StartDate

String

上门取货时间段:

"yyyy-MM-dd HH:mm:ss"格式化，本文中所有时间格式相同

EndDate

String

Weight

Double

物品总重量kg

Quantity

Int

件数/包裹数

Volume

Double

物品总体积m3

Remark

String

备注

IsNotice

Int

是否分发到快递公司：1-不分发；0-分发.默认为0

IsSendMessage

Int

是否订阅短信

0-不需要；1-需要

AddService

Name

String

增值服务名称

Value

String

增值服务值

CustomerID

String

客户标识(选填)

Commodity

GoodsName

String

商品名称

GoodsCode

String

商品编码

Goodsquantity

Int

件数

GoodsPrice

Double

商品价格

GoodsWeight

Double

商品重量kg

GoodsDesc

String

商品描述

GoodsVol

Double

商品体积m3

EBusinessID

String

商户ID

RequestType

String

请求指令类型：1008

DataSign

String

数据内容签名

DataType

String

请求、返回数据类型：2-json；

参数名称

类型

必须要求

说明

EBusinessID

String

电商用户ID

UpdateTime

String

时间

Success

Bool

成功与否:true,false

Reason

String

失败原因

EstimatedDeliveryTime

String

订单预计到货时间yyyy-mm-dd

{

}

{

}

即时查询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.security.MessageDigest;
import java.util.HashMap;
import java.util.Map;

快递鸟物流轨迹即时查询接口
DEMO中的电商ID与私钥仅限测试使用，正式环境请单独注册账号
单日超过500单查询量，建议接入我方物流轨迹订阅推送接口
ID和Key请到官网申请：http://www.kdniao.com/ServiceApply.aspx
*/

public class KdniaoTrackQueryAPI {

//DEMO public static void main(String[] args) {     KdniaoTrackQueryAPI api = new KdniaoTrackQueryAPI();     try {         String result = api.getOrderTracesByJson("ANE", "210001633605");         System.out.print(result);      } catch (Exception e) {         e.printStackTrace();     } }  //电商ID private String EBusinessID="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx"; //电商加密私钥，快递鸟提供，注意保管，不要泄漏 private String AppKey="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx"; //请求url private String ReqURL="http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx";     /**  * Json方式 查询订单物流轨迹  * @throws Exception   */ public String getOrderTracesByJson(String expCode, String expNo) throws Exception{     String requestData= "{'OrderCode':'','ShipperCode':'" + expCode + "','LogisticCode':'" + expNo + "'}";      Map<String, String> params = new HashMap<String, String>();     params.put("RequestData", urlEncoder(requestData, "UTF-8"));     params.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 编码方式  * @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 = result[i] & 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 UnsupportedEncodingException{     String encoded = base64Encode(str.getBytes(charset));     return encoded;     }     @SuppressWarnings("unused") private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{     String result = URLEncoder.encode(str, charset);     return result; }  /**  * 电商Sign签名生成  * @param content 内容     * @param keyValue Appkey    * @param charset 编码方式  * @throws UnsupportedEncodingException ,Exception  * @return DataSign签名  */ @SuppressWarnings("unused") private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception {     if (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<String, String> 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<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 = new BufferedReader(                 new InputStreamReader(conn.getInputStream(), "UTF-8"));         String line;         while ((line = in.readLine()) != null) {             result.append(line);         }     } catch (Exception e) {                     e.printStackTrace();     }     //使用finally块来关闭输出流、输入流     finally{         try{             if(out!=null){                 out.close();             }             if(in!=null){                 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', '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 < 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]);      }      return sb.toString();  }

}

物流跟踪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请到官网申请：http://www.kdniao.com/ServiceApply.aspx
*/

public class KdniaoSubscribeAPI {

//DEMO public static void main(String[] args) {     KdniaoSubscribeAPI api = new KdniaoSubscribeAPI();     try {         String result = api.orderTracesSubByJson();         System.out.print(result);      } catch (Exception e) {         e.printStackTrace();     } }  //电商ID private String EBusinessID="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx"; //电商加密私钥，快递鸟提供，注意保管，不要泄漏 private String AppKey="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx"; //测试请求url private String ReqURL = "http://testapi.kdniao.cc:8081/api/dist"; //正式请求url //private String ReqURL = "http://api.kdniao.cc/api/dist";  /**  * Json方式  物流信息订阅  * @throws Exception   */ public String orderTracesSubByJson() throws Exception{     String requestData="{'OrderCode': 'SF201608081055208281'," +                             "'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 = new HashMap<String, String>();     params.put("RequestData", urlEncoder(requestData, "UTF-8"));     params.put("EBusinessID", EBusinessID);     params.put("RequestType", "1008");     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 < result.length; i++) {         int val = result[i] & 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 UnsupportedEncodingException{     String encoded = base64Encode(str.getBytes(charset));     return encoded;     }     @SuppressWarnings("unused") private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{     String result = URLEncoder.encode(str, charset);     return result; }  /**  * 电商Sign签名生成  * @param content 内容     * @param keyValue Appkey    * @param charset 编码方式  * @throws UnsupportedEncodingException ,Exception  * @return DataSign签名  */ @SuppressWarnings("unused") private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception {     if (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<String, String> 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<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 = new BufferedReader(                 new InputStreamReader(conn.getInputStream(), "UTF-8"));         String line;         while ((line = in.readLine()) != null) {             result.append(line);         }     } catch (Exception e) {                     e.printStackTrace();     }     //使用finally块来关闭输出流、输入流     finally{         try{             if(out!=null){                 out.close();             }             if(in!=null){                 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', '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 < 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]);      }      return sb.toString();  }

}

标签

string

api接口