物流常用API接入流程总结-快递鸟

时间:2024-02-21 22:07:56

1、注册快递鸟账号

网址:http://www.kdniao.com/reg

2、登录快递鸟用户后台

网址:http://www.kdniao.com/login

 

注:登录快递鸟用户后台默认加载页或者点击菜单(我的会员中心)可以看到用户ID和API Key, 分别对应各接口文档中的EBusinessID、AppKey。(EBusinessID=用户ID,AppKey =API Key),

测试的过程中,我们用快递鸟提供的测试用户ID和API Key

测试商户ID:test1617571

测试API key:554343b2-7252-439b-b4eb-1af42c8f2175(此Key仅限测试环境使用)

 

3、实名认证

 

注:

3.1、认证类型、应用类型 如实选择即可,类型的选择不会影响接口的使用, 接口返回的数据也与选择结果无关;

3.2,必须实名认证,这一步很重要,没有认证是无法使用接口的。

3.3、标记为*的为必填,要求上传清晰、jpg格式且小于2M的证件图片;

3.4、技术对接人信息填写我们公司的技术人员,暂时没有,可先填自己的信息;

3.5、如还有其他疑问可加入商务合作群(群号:616310430)进行咨询。

 

 

4、开通会员服务

 

    4.1、物流查询(免费版)会员套餐为免费版,有效期1年结束后,如在近3个月内有数据交互系统会自动免费续期;

5、开发对接

5.1、切记,请求接口之前一定要实名认证并开通相关会员服务,否则会请求失败并返回提示“未申请开通接口”;

5.2、可下载“快递鸟接口技术文档”进行参考;

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

 

5.3、可下载“即时查询demo”进行参考(仅提供了.NET、Java、PHP三种语言demo);

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

 

5.4、查看快递公司对应快递鸟的编码可以下载“快递鸟接口支持快递公司编码列表.xlsx”。

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

 

5.5、接入过程中如有疑问请先参考快递鸟官网常见问题进行解决(http://www.kdniao.com/help),也可以进入快递鸟官网加入技术对接群(群号:620453345)进行咨询。

5.6、接口请求对应指令

即时查询(RequestType:1002/8001)

物流跟踪(RequestType:1008/8008)

电子面单(RequestType:1007)

预约取件(RequestType:1001)

单号识别(RequestType:2002)

上门取件(RequestType:1801)

代收货款(RequestType:9001)

隐私快递(RequestType:3001)

智选物流(RequestType:2006)

物流短信(RequestType:8102)

物流评价(RequestType:1011)

实名寄件(RequestType:1021)

5.7、其它开发总结

5.7.1 订阅推送,推送时会推送requestType、requestData和DataSign三个参数,我们开发一个接收地址,接收这三个参数,成功接收后需要在5S内做出响应,按快递鸟提供的报文格式返回成功接收的报文,否则会超时。快递鸟会再次推送此数据,建议大家接收到快递鸟的推送数据后,储存并马上返回响应。或许在根据自己业务需求处理报文, 如果我们先进行处理,再做出响应,耗时会比较久,会造成网络超时,传输效率低下。会造成快递鸟重复推送信息的情况发生。 快递鸟普通用户一般推送时效为2-12小时。

推送规则,在没有返回信息或者返回不符合规定的情况下,快递鸟会判断推送失败。推送失败后会重试推送2次,首次间隔15分钟,二次间隔30分钟,两次都失败就不会再推送,直到下次有轨迹更新才会再次推送。建议我们严格按照技术文档进行返回

    5.7.2、沙箱调试平台配置回调地址,测试推送接口,回调地址是我们提供给快鸟,

沙箱调试平台地址:http://kdniao.com/UserCenter/v2/SandBox/PushQueryParam.aspx

我们提供的回调地址一定是外网可以访问的地址。不支持内容地址。

测试、配置步骤如下:

 

 

 

5.8、快递鸟并发要求

      即时查询接口:并发不超过10次/秒

物流跟踪订阅接口:并发不超过30次/秒

电子面单接口:并发不超过20次/秒

 

5.9、返回‘无可用套餐’情况

1、即时查询接口限量,免费版每日查询量有500次的限制,超过500次后,请求返回“无可用套餐”,次日可以正常请求。

登录用户后台查看当天使用量:

(http://www.kdniao.com/UserCenter/v2/Public/ProductDashboard.aspx?guid=6d25d765-c978-40d5-a63c-0f5e7835336b)。

 

2、订购会员服务到期,到期后请求返回“无可用套餐”,需要重新订购。