物流常用API接入流程总结-快递鸟
1、注册快递鸟账号
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、订购会员服务到期,到期后请求返回“无可用套餐”,需要重新订购。