此接口支持***顺丰、EMS、申通、圆通、韵达、汇通、中通、天天、德邦、极兔、京东、全峰***等主流快递公司
目的
便于用户理解快递单号查询接口作用并正确应用到实际场景。
接口作用
轨迹类接口包含:即时查询接口和物流跟踪接口。
即时查询接口:实时查询某个快递单号当前的物流状态;
物流跟踪接口:监控某个快递单号完整的物流状态。
应用场景
可应用于电商平台、自营商城、ERP、打单工具、楼宇/物业系统、云打印、微信小程序/公众号、APP、OA等需要查看物流信息的场景。
接口逻辑
说明:
快递鸟接口作为数据中转站,不对物流信息做处理,不做语言转换,只对数据字段做转换,分析物流状态;
快递鸟接口返回的物流轨迹信息按照发生时间的升序排列。
应用方法:
接口返回物流信息后直接展示
优势:方便简单
劣势:受网络影响,响应较慢,用户体验欠佳
接口返回物流信息后保存在本地数据库,当用户查询时调用本地数据再做展示
优势:本地调用响应快,不受网络影响,用户体验好
劣势:需本地保存
应用实例
类似微信扫一扫查快递,通过扫一扫功能扫描面单上的条码跟踪物流状态(需结合快递鸟单号识别接口使用);——适用即时查询接口
前端展示单号轨迹框,由用户填写单号后查询对应物流信息(可结合快递鸟单号识别接口使用);——适用即时查询接口
输入快递单号,显示可能属于的快递公司列表
选择对应的快递公司后,展示详细的物流信息。
电商平台、自营商城等展示订单的物流信息,可监控平台商家是否按时发货;——适用物流跟踪接口
APP上展示订单流转路径;——适用物流跟踪接口
发送物流节点短信通知;——适用物流跟踪接口
数据报表;——适用物流跟踪接口
物流体验:分析每天快件状态,统计揽收率、签收率、问题件率等;——适用物流跟踪接口
退货险:平台根据快件流转的时间、揽件城市、签收城市等数据判断商家是否虚假退货;——适用物流跟踪接口
轨迹拼接:转动公司/平台,将海外订单的物流信息和国内清关后的物流信息拼接在一起,方便买家查询海淘订单;——适用物流跟踪接口
对接指南
1、登录快递鸟官网注册页面注册快递鸟账号
网址:http://www.kdniao.com/reg
2、登录快递鸟用户管理后台
网址:http://www.kdniao.com/login
注:登录快递鸟用户管理后台后获得用户ID和APIKey,此用于保证应用来源的可靠性,避免应用伪造,被不法使用。
3、进入“我的会员中心”进行实名认证
注:
3.1、认证类型、应用类型根据用户实际情况选择即可,接口返回数据与选择结果无关;
3.2、标记为*的为必填,要求上传清晰、jpg格式且小于2M的证件图片;
3.3、技术对接人信息为用户方对接工程师的信息;
3.4、如有其他疑问可进入官网加入商务合作群进行咨询。
4、认证成功后,进入“产品服务管理”,开通相关会员服务
注:
4.1、物流查询(免费版)会员套餐为免费版,有效期1年结束后,如在近3个月内有数据交互系统会自动免费续期;
4.2、如有其他疑问可进入官网加入商务合作群进行咨询。
5、开发对接
5.1、即时查询(RequestType:1002/8001)
5.1.1、请求接口之前需要先实名认证,开通相关会员服务,否则会请求失败并返回提示“未申请开通接口”;
5.1.2、接口开发可以下载“快递鸟接口技术文档”进行参考;即时查询,参考技术文档中的4.1或5.1.1部分;
5.1.3、接口开发可以下载“即时查询demo”进行参考(仅提供了.NET、Java、PHP三种语言demo);
5.1.4、查看快递公司对应快递鸟的编码可以下载“2019快递鸟接口支持快递公司编码列表.xlsx”。
5.1.5、接入过程中如有疑问请先参考快递鸟官网常见问题进行解决(http://www.kdniao.com/help),也可以进入快递鸟官网加入技术对接群进行咨询。
注:快递鸟官网-帮助与文档地址(http://www.kdniao.com/documents )
快递鸟API接口DEMO下载:http://www.kdniao.com/documents-demo