免费快递查询接口不限量对接

来源:互联网 发布:百度新闻下載软件 编辑:程序博客网 时间:2024/04/29 02:16

    快递查询接口(物流跟踪接口)是快递鸟为用户提供的定制化服务,用户可将订单信息通过快递鸟订阅给快递公司,快递公司更新轨迹后,快递鸟将实时转换成快递鸟标准接口形式,推送给用户,起到实时推送的作用,提高效率。物流跟踪接口不限调用单量,适用于量大的电商、ERP系统商、仓储和快递柜公司,量小的可以对接即时查询接口。

    订单接收的信息(分给了的网点,业务员的信息),会通过推送接口推给客户(订阅并发不超过30次/S)客户需要按要求实现接口;仅支持Json格式;请求指令1008;测试接口地址:http://testapi.kdniao.cc:8081/api/dist;联调通过后请更换为正式地址:http://api.kdniao.cc/api/dist;分发及订阅接口需要客户方实现回调接口,回调RequestType(1008)

    

    对接参数:

系统级输入参数

应用级输入参数

类型

是否必须

描述

RequestData(必填参数,请求内容,JSON格式,须和DataType一致))

CallBack

String

O

用户自定义回调信息

MemberID

String

O

会员标识(备用字段)

WareHouseID

String

O

仓库标识(备用字段)

CustomerName

String

O

电子面单客户账号

(与快递网点申请)

CustomerPwd

String

O

电子面单密码

SendSite

String

O

收件网点标识

ShipperCode

String

R

快递公司编码

LogisticCode

String

R

快递单号

OrderCode

String

O

订单编号

MonthCode

String

O

月结编码

PayType

Int

O

邮费支付方式:

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

ExpType

String

O

快递类型:1-标准快件

Cost

Double

O

寄件费(运费)

OtherCost

Double

O

其他费用

Receiver

Company

String

O

收件人公司

Name

String

O

收件人

Tel

String

O

电话

Mobile

String

O

手机

PostCode

String

O

收件人邮编

ProvinceName

String

O

收件省(如广东省,不要缺少“省”)

CityName

String

O

收件市(如深圳市,不要缺少“市”)

ExpAreaName

String

O

收件区(如福田区,不要缺少“区”或“县”)

Address

String

O

收件人详细地址

Sender

Company

String

O

发件人公司

Name

String

O

发件人

Tel

String

O

发件人电话

Mobile

String

O

发件人手机

PostCode

String

O

发件人邮编

ProvinceName

String

O

发件省(如广东省,不要缺少“省”)

CityName

String

O

发件市(如深圳市,不要缺少“市”)

ExpAreaName

String

O

发件区(如福田区,不要缺少“区”或“县”)

Address

String

O

发件详细地址

StartDate

String

O

上门取货时间段:

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

EndDate

String

O

Weight

Double

O

物品总重量kg

Quantity

Int

O

件数/包裹数

Volume

Double

O

物品总体积m3

Remark

String

O

备注

IsNotice

Int

O

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

IsSendMessage

Int

O

是否订阅短信

0-不需要;1-需要

AddService

Name

String

0

增值服务名称

Value

String

0

增值服务值

CustomerID

String

0

客户标识(选填)

Commodity

GoodsName

String

O

商品名称

GoodsCode

String

O

商品编码

Goodsquantity

Int

O

件数

GoodsPrice

Double

O

商品价格

GoodsWeight

Double

O

商品重量kg

GoodsDesc

String

O

商品描述

GoodsVol

Double

O

商品体积m3

EBusinessID

 

String

R

商户ID

RequestType

String

R

请求指令类型:1008

DataSign

String

R

数据内容签名

DataType

String

R

请求、返回数据类型:2-json;


返回参数

参数名称

类型

必须要求

说明

EBusinessID

String

R

电商用户ID

UpdateTime

String

R

时间

Success

Bool

R

成功与否:true,false

Reason

String

O

失败原因

EstimatedDeliveryTime

String

O

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



JAVA对接demo

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 {//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="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx";//电商加密私钥,快递鸟提供,注意保管,不要泄漏private String AppKey="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx";//测试请求urlprivate 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();     }}