免费物流快递API接口的要求

本文涉及的产品
密钥管理服务KMS,1000个密钥,100个凭据,1个月
简介: 一家一家快递公司去对接查询接口,比较耗时、耗成本,一般都会选择集成物流接口服务商,淘系用菜鸟,非淘系的用快递鸟,快递鸟是第三方物流接口服务商中比较好的,集成了全球418家物流快递公司接口,为电商平台、电商系统商(ERP)、仓储(WMS)、小程序等有系统的用户提供智选物流、预约取件、实名快递、电子...

_

一家一家快递公司去对接查询接口,比较耗时、耗成本,一般都会选择集成物流接口服务商,淘系用菜鸟,非淘系的用快递鸟,快递鸟是第三方物流接口服务商中比较好的,集成了全球418家物流快递公司接口,为电商平台、电商系统商(ERP)、仓储(WMS)、小程序等有系统的用户提供智选物流、预约取件、实名快递、电子面单、隐私快递、快递单号查询、快递单号智能识别、物流评价、物流短信提醒等全流程的物流接口解决方案,接口比较全面,支持的快递公司多,接口稳定性及时性准确性都有保障,电商平台蘑菇街、拼多多、国美、网易考拉接的就是快递鸟的接口,也有很多ISV服务商(比如网店管家、商派、E店宝)也对接了快递鸟API,使用快递鸟物流查询API接口的用户很多(有十几个千人技术QQ群),淘系用菜鸟,非淘系的用快递鸟,快递鸟是第三方物流接口服务商中用户使用最多的,服务数据量最大的,日服务单在3000万+以上,服务体系也比较完善,有专门的客服、在线的技术支持、上门的技术服务指导、专业的物流方案服务顾问,在北京上海主要城市设有分公司团队,和大部分物流快递公司有接口对接及战略合作协议,确保数据的安全稳定及时准确,整个对接过程也挺简单的,到快递鸟网站注册申请到ApiKey和商户ID,对接后联调测试后上线就可以使用了,在快递鸟网站也可下载demo,对接更简单便捷,一次性对接418家物流快递公司接口。那么使用快递鸟api接口有哪些规则呢?

本文档就各个API接口进行详细说明,方便用户快速对接及使用快递鸟api接口服务。

1 接口规范说明

1.1 接口规范及说明

1.1.1 报文及报文编码

报文格式:Json格式

请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"

交互协议上统一用UTF-8,避免传递中文数据出现乱码。

1.1.2 接口数据包结构
_1

图例- 数据包结构(系统级{数据})

1.1.3 JSON示例

string used = "1237100";//仅作为示例ID,不可用来实际使用
//加密私钥,由快递鸟提供
string keyValue = "56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17";//仅作为示例Key,不可用来实际使用
//请求地址
string url = "http://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";
//通讯协议使用Http协议Post请求方式
string post = this.DoPost(url, PostStr);

1.1.4 系统级参数

_2

*快递所有接口统一使用此系统级参数,根据不同的请求接口指令接入不同的接口。

1.1.5 流程示意图

1.1.6 名词定义

必须要求

说明

R

必填(Required)。

O

可选(Optional)

C

一定条件下可选(Conditional)

1.2 签名说明

1.2.1 关于签名

快递鸟和第三方电子商务公司系统进行对接,有一定的安全机制。采用IP认证加签名的方式对接,具体方案如下:
_3

1.防止数据被篡改

在POST请求中会传递5个必须(R)参数

RequestData==数据内容(URL编码:UTF-8)

EBusinessID==用户ID

RequestType=请求指令类型

DataSign== 数据内容签名:把(请求内容(未编码)+ApiKey)进行MD5加密,然后Base64编码,最后进行URL(utf-8)编码

DataType==2(返回数据类型为json)

注:

DataSign生成后,对方接收到数据后,以同样的算法进行签名(推送接口RequestType为101/102不需要进行URL编码),生成摘要,对比两者的摘要是否相同,如果不同,说明传递过程中发生数据篡改。

2.调用接口的身份认证

注册成为快递鸟用户后,会生成对应的用户ID和APIKey,用户ID相当于用户名,APIKey相当于密码。

举例:

1.假设

RequestData (JSON)内容为:

{'OrderCode':'','ShipperCode':'SF','LogisticCode':'118954907573'}

经过URL(UTF-8)编码的内容为:

%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27SF%27%2c%27LogisticCode%27%3a%27118954907573%27%7d;

EBusinessID=1237100【示例ID,不可用来实际使用】

APIKey=56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17【示例Key,不可用来实际使用】

2.那么DataSign签名的内容为

{'OrderCode':'','ShipperCode':'SF','LogisticCode':'118954907573'}56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17

经过md5和base64后的内容就为:OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE=,

在经过URL(UTF-8)编码的内容为:OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE%3d

最终要发送的数据为:

RequestType=1002&EBusinessID=1237100&RequestData =%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27SF%27%2c%27LogisticCode%27%3a%27118954907573%27%7d&DataSign=OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE%3d&DataType=2

3.接收方收到数据后,获得

EBusinessID 和RequestData和DataSign等这几个数据。

4.接收方对EBusinessID得到APIKey,RequestData+APIKey的数据进行

md5和base64后的内容就为

OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE=

5.接收方判断签名后的数据跟传递过来的DataSign是否一致,如果一致进行业务操作,如果不一致返回错误。

1.2.2 (C#)DataSign签名加密代码

///<summary>

///电商Sign签名

///</summary>

///<param name="content">内容</param>

///<param name="keyValue">APIkey</param>

///<param name="charset">URL编码 </param>

///<returns>DataSign签名</returns>

Public String Encrypt (String content, String keyValue, String charset)

{

if (keyValue != null)

{

return base64(MD5(content + keyValue, charset), charset);

}

return base64(MD5(content, charset), charset);

}

///<summary>

/// 字符串MD5加密

///</summary>

///<param name="Text">要加密的字符串</param>

///<returns>密文</returns>

Private string MD5(string Text, string charset)

{

byte[] buffer = System.Text.Encoding.GetEncoding(charset).GetBytes(Text);

try

{

System.Security.Cryptography.MD5CryptoServiceProvider check;

check = new System.Security.Cryptography.MD5CryptoServiceProvider();

byte[] somme = check.ComputeHash(buffer);

string ret = "";

foreach (byte a in somme)

{

if (a < 16)

ret += "0" + a.ToString("X");

else

ret += a.ToString("X");

}

return ret.ToLower();

}

catch

{

throw;

}

}

Private static string base64(String str, String charset)

{

returnConvert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));

}

1.3 接入步骤

1.快递鸟官网注册账号成为快递鸟用户;

快递鸟提供的用户ID是调用接口服务的身份证明,不可更改、不可转用,API Key是应用访问API的签名附加密钥,必须妥善保存。两者关系类似于用户名和密码,两者都会在签名和业务参数中使用。

官网登录网址:

http://www.kdniao.com/

官网注册网址:

http://www.kdniao.com/reg

官网接口介绍网址:

http://www.kdniao.com/api-all

2.登陆用户后台,进行实名认证,并开通会员服务;

3.根据技术文档进行开发并在调试平台测试联调;

快递鸟提供各个API接口的DEMO(包括:.Net版本、Java版本、PHP版本)供开发参考。

DEMO下载地址:http://www.kdniao.com/documents-demo...

4.系统发布上线。

注意:测试环境中获取的测试快递单号不可用于实际发货。

相关文章
|
10天前
|
JSON API 开发工具
淘宝实时 API 接口丨淘宝商品详情接口(Taobao.item_get)
淘宝商品详情接口(Taobao.item_get)允许开发者获取商品的详细信息,包括基本信息、描述、卖家资料、图片、属性及销售情况等。开发者需注册账号、创建应用并获取API密钥,通过构建请求获取JSON格式数据,注意遵守平台规则,合理使用接口,确保数据准确性和时效性。
|
11天前
|
JSON 安全 API
Python调用API接口的方法
Python调用API接口的方法
53 5
|
10天前
|
JSON 缓存 监控
淘宝商品详情接口(Taobao.item_get)丨淘宝API接口指南
淘宝商品详情接口(Taobao.item_get)允许开发者通过HTTP GET方法获取淘宝商品的详细信息,包括商品ID、价格、库存等。请求需包含key、secret、num_iid等必选参数,支持缓存及多种返回格式。此接口广泛应用于电商数据分析、商品选品、价格监控等领域,提升商家运营效率。
|
14天前
|
JSON 搜索推荐 API
LAZADA关键词搜索API接口的获取与应用
Lazada作为东南亚领先的电商平台,为满足开发者和商户需求,开放了关键词搜索API接口。本文详细介绍该接口的获取与应用,助力提升电商业务效率。接口支持关键词搜索、指定搜索范围和排序方式,提供精准、灵活且全面的数据支持,促进电商应用和服务的优化与创新。
21 3
|
25天前
|
JSON API 数据格式
淘宝 / 天猫官方商品 / 订单订单 API 接口丨商品上传接口对接步骤
要对接淘宝/天猫官方商品或订单API,需先注册淘宝开放平台账号,创建应用获取App Key和App Secret。之后,详细阅读API文档,了解接口功能及权限要求,编写认证、构建请求、发送请求和处理响应的代码。最后,在沙箱环境中测试与调试,确保API调用的正确性和稳定性。
|
1月前
|
供应链 数据挖掘 API
电商API接口介绍——sku接口概述
商品SKU(Stock Keeping Unit)接口是电商API接口中的一种,专门用于获取商品的SKU信息。SKU是库存量单位,用于区分同一商品的不同规格、颜色、尺寸等属性。通过商品SKU接口,开发者可以获取商品的SKU列表、SKU属性、库存数量等详细信息。
|
21天前
|
JSON API 数据库
电商拍立淘按图搜索API接口,数据格式示例
电商拍立淘按图搜索API接口系列为电商平台和购物应用提供了强大的图像搜索功能,以下是其文档说明的详细参考
|
23天前
|
Web App开发 API Windows
取接口访问者信息[IP,浏览器,操作系统]免费API接口教程
此API用于获取访问者的IP地址、浏览器和操作系统信息,支持70多种浏览器和操作系统。通过POST或GET请求至`https://cn.apihz.cn/api/ip/getapi.php`,需提供用户ID和KEY。返回结果包括状态码、消息、IP、浏览器和操作系统信息。示例:{&quot;code&quot;:200,&quot;ip&quot;:&quot;175.154.88.178&quot;,&quot;browser&quot;:&quot;Chrome&quot;,&quot;os&quot;:&quot;Windows 10&quot;}。详情见官网文档。
|
28天前
|
JSON API 数据安全/隐私保护
拍立淘按图搜索API接口返回数据的JSON格式示例
拍立淘按图搜索API接口允许用户通过上传图片来搜索相似的商品,该接口返回的通常是一个JSON格式的响应,其中包含了与上传图片相似的商品信息。以下是一个基于淘宝平台的拍立淘按图搜索API接口返回数据的JSON格式示例,同时提供对其关键字段的解释
|
1月前
|
JSON 前端开发 JavaScript
API接口商品详情接口数据解析
商品详情接口通常用于提供特定商品的详细信息,这些信息比商品列表接口中的信息更加详细和全面。以下是一个示例的JSON数据格式,用于表示一个商品详情API接口的响应。这个示例假定API返回一个包含商品详细信息的对象。