快递鸟API接口技术规范说明文档
快递鸟
API
旨在为电商、电商平台、物流工具、打单工具、仓储系统、移动
APP
等系统提供专业、稳定、优质的 API
接口服务,满足不同用户的物流管理需求。
本文档就各个
API
接口进行详细说明,方便用户快速对接及使用快递鸟服务。
1.接口规范及说明
1.1
报文及报文编码
报文格式:
Json
格式
请求方法的编码格式
(utf-8)
:
"application/x-www-form-urlencoded;charset=utf-8"
交互协议上统一用
UTF-8
,避免传递中文数据出现乱码。
1.2
接口数据包结构
图例
-
数据包结构
(
系统级
{
数据
})
1.3 JSON 示例
string
used =
"1237100"
;
//仅作为示例ID,不可用来实际使用
//加密私钥,由快递鸟提供
string
keyValue =
"56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17"
;
//仅作为示例Key,不可用
来实际使用
//请求地址
string
url =
"https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx"
;
//2-json
string
DataType =
"2"
;
//字符编码采用UTF-8
string
charset =
"UTF-8"
;
//JSON字符串string
string
jsonStr =
"{\"OrderCode\":\"\",\"ShipperCode\":\"SF\",\"LogisticCode\":\"118461988807\"}"
;
//把(jsonStr+APIKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码
datasign = HttpUtility.UrlEncode(base64(MD5(jsonStr + keyValue,
"UTF-8"
),
"UTF-8"
), Encoding.UTF8);
//请求报文参数
string
PostStr =
"RequestType=1002&EBusinessID= used &RequestData=jsonStr
&DataSign= datasign&DataType=DataType"
;
//通讯协议使用Https协议Post请求方式
string
post =
this
.DoPost(url, PostStr);
1.4 系统级参数
1.5 流程示意图
1.6 名词定义
快递鸟API提供实时查询物流轨迹接口服务,支持顺丰、圆通、中通、申通、韵达、EMS、百世、天天等1600+家快递物流轨迹查询API接口,官网注册账户免费试用地址:快递单号查询接口_电子面单_APIKey授权申请–快递鸟账号注册