快递查询Api接口(快递鸟)
- 前提
- 应用场景
- 可实现需求
- 申请Key
- 快递查询Api接口
- 接口文档及各开发语言Demo
- 查询Api接口定义
- 系统级输入参数
- 应用级输入参数
- 返回结果参数
- 请求JSON参数
- 响应JSON参数
- 查询Api接口使用
- 温馨提示
- 同类文章
前提
项目开发中,有些需求难免会用到关于快递的一些Api接口;
如大家使用过,快递100和爱查快递等等网站提供的快递查询等接口时,唯一让你感到麻烦的是,要求用户添加外链,而快递鸟不需要用户添加外链。对于无门户网站的用户,无非就是很苛刻的要求;
固然,对于你小小的需求的话,基础版可满足你的需求;但是,当万一某天请求次数太多,你的查询服务就得停止,影响你的产品体验;所以,推荐你直接使用快递鸟企业版,一步到位。
应用场景
(1)电商网站用户打开“我的订单”时调用此API显示物流信息详情。
(2)电商管理后台的物流系统,客服在对账前查询所有运单的签收状态,并追踪问题。
(3)每日调用次数限制不超过500次,如超过该限制,请对接物流跟踪API。
(4)全流程的物流状态跟踪,即时查询无限次,请对接在途监控API
注册快递鸟&申请Key
http://www.kdniao.com/reg?from=srwleo
按照你的信息,依次把信息填写完整,点击提交申请即可。
登录成功后,就可以看到ID和key等信息,有这些信息就可以请求查询等其他的接口Api
快递查询Api接口
接口文档及各开发语言Demo
http://www.kdniao.com/download
查询Api接口定义
系统级输入参数
参数名称 | 类型 | 必须要求 | 说明 |
---|---|---|---|
RequestData | String | R | 请求内容,JSON或XML格式,须和DataType一致 |
EBusinessID | String | R | 用户ID |
RequestType | String | R | 请求指令类型:1002 |
DataSign | String | R | 数据内容签名 |
DataType | String | O | 请求、返回数据类型:1-xml,2-json;默认为xml格式 |
应用级输入参数
参数名称 | 类型 | 必须要求 | 说明 |
---|---|---|---|
OrderCode | varchar(50) | O | 订单编号 |
ShipperCode | varchar(10) | R | 快递公司编码 |
LogisticCode | varchar(50) | R | 物流单号 |
返回结果参数
参数名称 | 类型 | 必须要求 | 说明 |
---|---|---|---|
EBusinessID | Int | R | 电商用户ID |
OrderCode | Varchar(50) | O | 订单编号 |
ShipperCode | varchar(10) | R | 快递公司编码 |
LogisticCode | Varchar(50) | R | 物流运单号 |
Success | Bool | R | 成功与否 |
Reason | Varchar(50) | O | 失败原因 |
State | Int | R | 物流状态1:已取件2:在途中3:签收 |
Traces | Varchar(Max) | R | 物流轨迹详情 |
物流轨迹详情
参数名称 | 类型 | 必须要求 | 说明 |
---|---|---|---|
AcceptTime | DateTime | R | 时间 |
AcceptStation | Varchar(50) | R | 描述 |
Remark | Varchar(150) | O | 备注 |
请求JSON参数
{"OrderCode" : "","ShipperCode" : "SF","LogisticCode" : "118650888018"
}
响应JSON参数
{"EBusinessID" : "1109259","OrderCode" : "","ShipperCode" : "SF","LogisticCode" : "118461988807","Success" : true,"State" : 3,"Reason" : null,"traces" : [{"AcceptTime" : "2014/06/25 08:05:37","AcceptStation" : "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]","Remark" : null}, {"AcceptTime" : "2014/06/25 04:01:28","AcceptStation" : "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/25 01:41:06","AcceptStation" : "快件在 深圳集散中心 [深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/24 20:18:58","AcceptStation" : "已收件[深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/24 20:55:28","AcceptStation" : "快件在 深圳 ,准备送往下一站 深圳集散中心 [深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/25 10:23:03","AcceptStation" : "派件已签收[深圳市]","Remark" : null}, {"AcceptTime" : "2014/06/25 10:23:03","AcceptStation" : "签收人是:已签收[深圳市]","Remark" : null}]
}
查询Api接口使用
以Java开发语言为例,进行展开
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;
/**** 快递鸟物流轨迹即时查询接口** @技术QQ群: 456320272* @see: http://www.kdniao.com/YundanChaxunAPI.aspx* @copyright: 深圳市快金数据技术服务有限公司** DEMO中的电商ID与私钥仅限测试使用,正式环境请单独注册账号* 单日超过500单查询量,建议接入我方物流轨迹订阅推送接口* * ID和Key请到官网申请:http://www.kdniao.com/ServiceApply.aspx*/
public class KdniaoTrackQueryAPI {//DEMOpublic 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();}}//电商IDprivate String EBusinessID="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx";//电商加密私钥,快递鸟提供,注意保管,不要泄漏private String AppKey="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx";//请求urlprivate 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;}/*** XML方式 查询订单物流轨迹* @throws Exception */public String getOrderTracesByXml() throws Exception{String requestData= "<?xml version=\"1.0\" encoding=\"utf-8\" ?>"+"<Content>"+"<OrderCode></OrderCode>"+"<ShipperCode>SF</ShipperCode>"+"<LogisticCode>589707398027</LogisticCode>"+"</Content>";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", "1");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(); }}
其他Api接口,请转到快递鸟具体查看相关文档。
账号注册
http://www.kdniao.com/reg?from=srwleo
温馨提示
如你的产品需对接或集成快递接口,快递鸟是不错的选择;会给您提供专业的技术支持人员;
快递查询Api接口(快递鸟)相关推荐
- 各种快递查询Api接口(快递鸟)
文章目录 #应用场景 #申请Key #快递查询Api接口 #前提 项目开发中,有些需求难免会用到关于快递的一些Api接口:本篇主要介绍的是快递的查询Api及与其他各家的不同之处: 常用的提供快递Api ...
- trackingmore快递查询平台_快递查询API接口(trackingmore)
快递查询接口 目前提供快递查询的接口平台有: 不同接口的区别: (1)Trackingmore支持380家快递公司,其中有55家为国内的快递,其余325家为国际快递.具体的价格为0.6分钱/单号左右, ...
- 如何用C# 实现免费快递查询API接口对接
接口对接常见的问题基本上是数据签名错误导致的接口联调失败,而API接口是获取网络服务最便捷的方式,合理地使用API接口开发项目可以大大提高开发效率,把精力都集中在程序的业务逻辑之上,避免重复造轮子. ...
- 免费常用快递查询API接口及快递在线下单API分享
1.常用快递API 快递鸟支持顺丰.EMS.申通.圆通.韵达.汇通.中通.天天.德邦.全峰等国内外418家主流快递物流公司接口. 适用于电商网站.企业内部系统或者在线管理系统这种一般都是拥有一定需求量 ...
- 快递鸟Java开发快递查询api接口调用源码
快递鸟是专业的第三方物流数据服务商,国家高新技术企业,已先后完成四轮融资,一直专注于企业级物流API技术研发和打通物流各节点信息服务,致力于成为全球最大的物流信息枢纽中心,为零售电商企业级提供标准的物 ...
- 快递查询—API接口
前言 随着网购的发展,快递业也随之壮大.快递查询接口对接的需求量也越来越大,下面是对免费快递接口做的整理,并附上调用流程,分享给大家,望沟通指教. 快递查询接口提供方 我乐接口网 快递鸟 快递100 ...
- 爱快递查询API接口使用
爱快递简介: 爱快递提供国内90多家快递物流订单查询服务比如申通快递.顺丰快递.圆通快递.EMS快递.汇通快递.宅急送快递等知名快递订单查询服务, 该接口完全免费,可用于电子商城单号跟踪,手机应用,微 ...
- 全国快递查询API接口,支持国内外1500多家快递接口查询,物流信息追踪
一.接口介绍 支持国内外1500+快递物流公司的物流跟踪服务,包括顺丰.圆通.申通.中通.韵达等主流快递公司.同时,支持单号识别快递物流公司.按次与按单计费.物流轨迹返回等功能,以满足企业对快递物流查 ...
- 2022年最新快递查询API接口分享
支持平台:支持所有快递 请求方式:http get 返回格式:json 请求示例:https://www.345api.com/api/kuaidi/?key=key&id=快递单号 {&qu ...
最新文章
- WebForm中DataGrid的20篇经典文章
- Spring MVC 处理异常的3种方式
- Linux_《Linux命令行与shell脚本编程大全》第十八章学习总结
- 把软件架构演进体现在栈上
- 基于服务器的AAA作业(第二次)
- STL MAP(key,value)
- 二分图的最大带权匹配
- execl中一串字符,以某个分隔符分开,公式实现
- 关于格雷码的规律、转换
- [AWS vs Azure] 云计算里AWS和Azure的探究(4)
- 次时代模型的制作 这几个点你真的知道了吗?|附加50g学习资料
- swift-switch使用方法
- 百度编辑器上传图片地址+上域名,让上传图片保存全路径
- Redis中的布隆过滤器与布谷鸟过滤器,你了解多少?
- 任意多边形面积的计算
- 什么是单例模式以及单例模式的几种实现
- 在 JavaScript 中为任何表格添加分页
- Android_百度地图API_图形“圆形”(正多边形)和多边形是否相交算法
- freerdp 解压安装_Linux下安装FreeRDP,连接Windows远程桌面好软件软件.doc
- 音视频 RTMP协议分析