快递api对接（对接第三方快递单号查询接口获取物流信息免费申请APIKey）

快递鸟是中国领先的第三方物流接口服务商，国家高新技术企业，已先后完成四轮融资，一直专注于企业级物流API技术研发和打通物流各节点信息服务，致力于成为全球最大的物流信息枢纽中心，为零售电商企业级提供标准的物流接口和物流模块整体解决方案，为开发者聚合600 快递物流公司接口，可一次性快速对接完成，实现物流轨迹信息查询、电子面单批量打印、预约快递员上门取件等一站式物流模块功能植入，在快递鸟网免费注册申请APIKey立即对接，可申请免费试用。

快递鸟·专业第三方物流接口服务商

快递鸟API查询接口支持包括顺丰、中通、韵达、圆通、申通、百世、EMS、邮政等600家以上快递物流公司，是专注做物流接口的， 第三方物流接口中做的比较好的。详情点击查看快递鸟支持的快递公司列表。

快递鸟目前每日物流数据服务量达上千万单，上下游数据交换上千亿次，经过将近10年的物流接口产品打磨，一直专注于企业级快递API技术研发，拥有海量级快递物流信息传输、存储、计算能力，接口及时准确稳定性非常好，腾讯、12306、跟谁学、猿辅导、蘑菇街、建设银行、中通云仓、旺旺集团、美柚、美团、美的集团、唯品会、斑马会员，药师帮，屈臣氏、贝店、云集、趣店、学而思、水滴筹、凯叔讲故事、网易云音乐、中国电信、快手电商等知名企业都在用快递鸟API提供的物流接口服务。

对接快递查询接口获取物流轨迹应用场景

嵌入ERP、网站、APP，实时查看物流轨迹

商家发货后，实现轨迹查询的实时更新，根据物流轨迹自动判断物流状态并推送给ERP系统：如已揽件、到达派件城市、派送中、已签收、问题件等信息节点。用户可根据对应的状态发送短信、跟踪订单等操作。

对接使用流程

1、将快递单号和快递公司编码发送給快递鸟

2、快递鸟根据单号和快递公司查询到物流轨迹状态

3、快递鸟将查询到的物流轨迹状态反馈給电商平台或ISV服务商

4、电商平台或ISV服务商接收数据并实时处理做数据展示或应用

接口描述说明

（1）查询接口支持按照运单号查询(单个查询)。

（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。 如：EMS物流单号应选择快递公司编码（EMS）查看下载快递鸟快递公司编码

（3）返回的物流跟踪信息按照发生的时间升序排列。

（4）接口指令1002。

（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。

（6）测试调用地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json

（7）正式调用地址：http://api.kdniao.com/api/dist

（8）返回类型：JSON

（9）调试页面：http://kdniao.com/UserCenter/v2/SandBox/TrackQuery.aspx

（10）调试工具：去调试（使用快递鸟账号登录）

前期准备工作

去快递鸟官网免费注册一个账号，免费获得一个apiKey(接口权限验证需要)，完成实名认证流程，订购一个免费或付费套餐（也可找快递鸟工作人员免费申请付费的接口测试联调）

快递鸟技术开发文档下载快递鸟demo下载

注：登录快递鸟用户管理后台后获得用户ID和APIKey对应各demo中的EBusinessID、AppKey。

小知识：EBusinessID跟APIKey是什么？EBusinessID跟APIKey您在快递鸟网站注册之后快递鸟分配的密钥（对应官网上的用户ID和API key），用于保证应用来源的可靠性，避免应用伪造，被不法使用。说明：未实名认证，未订购套餐，套餐可用查询量已经用完 都会返回此报文信息去实名认证/ 了解套餐详情

分步讲解（C#版本）请求数据包结构

返回码定义

100成功

101缺少必要参数

102校验问题

103格式问题

14、关于沙箱调试

在沙箱调试平台配置回调地址，测试推送接口。回调地址是用户提供，用于接收快递鸟推送的物流信息的，只要是外网可以访问的就行。测试、配置步骤如下：

a、填写回调地址：

b、点击【生成】后 应用级参数报文(RequestData)就是推送到用户第一步时填写的回调地址上的测试物流信息。

c、点击【调用】，用户接收到测试的物流信息后，用户需要在 应用级参数报文区域 返回成功接收的信号给快递鸟（注：字段间不要存在空格，空格会影响返回结果），

返回格式：{"EBusinessID":"1237100","UpdateTime":"2015-03-11 16:26:11","Success":true,"Reason": ""}

d、调用结果显示为请求成功后即用户开发的推送接口通过测试。

e、测试通过后回到第一步填写回调地址的位置点击【配置】，弹出弹框，填写手机号（必须是注册快递鸟账号的手机号）、验证码、

回调地址，点击【保存】配置成功即可在正式环境使用，下次如果需要修改回调地址同初次配置回调地址步骤一致。

对接中的其他说明

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

2、即时查询（RequestType：1002/8001）日查询次数<=3000次对接即时查询接口

3、请求接口之前需要先实名认证，开通相关会员服务，否则会请求失败并返回提示“未申请开通接口”；

4、接口开发可以下载“快递鸟接口技术文档”进行参考；即时查询，参考技术文档中的4.1或5.1.1部分；

5、物流跟踪（RequestType：1008/8008）日查询次数>3000次对接物流跟踪接口

6、测试订阅接口，对照技术文档正确返回代表订阅接口对接成功，详情可见技术文档。

7、开发推送接口，无demo提供，推送时会推送requestType、requestData和DataSign三个参数，您开发一个推送接口接收这三个参数就行，成功接收后需要在5S内给快递鸟返回成功收数据的报文，否则超时。RequestData中包含应用级参数，即物流轨迹（详情看技术文档）；

8、订阅接口、推送接口分别测试成功后，可使用正式地址进行订阅真实的快递单号，快递鸟一般会在2-12小时内推送物流信息至您已经配置好的回调地址上；

可能还关心的问题解答

1、问题：快递鸟接口有并发要求吗？

快递鸟即时查询接口并发不超过10次/秒,物流跟踪接口订阅不超过30次/秒,电子面单接口下单不超过20次/秒。

2、问题：快递鸟api收费标准是什么？

快递鸟查询接口和电子面单等接口有免费提供的，如果您对数据的状态时效、服务等有特别的需求，可联系快递鸟工作人员，为您量身定制专属解决方案，具体收费会根据您的需求进行商定。

3、问题：快递鸟数据更新实时性如何？

即时查询接口：实时获取当前最新轨迹信息，数据与官网信息一致。

物流跟踪接口：快递鸟每2小时到快递公司获取轨迹，如果您订阅的单号没有轨迹更新，间隔2小时后再次到快递公司获取轨迹，依次循环直到有物流轨迹更新，获取到新轨迹后进行排队序列推送。

4、问题：快递鸟数据准确性，会不会存在物流状态不准确的问题？

轨迹信息准确度大于99.9%。物流轨迹信息保持与快递公司官网一致，偶尔存在快递公司提供的接口数据与官网不一致的情况，不一致情况小于0.1%。

5、问题：快递鸟即时查询接口和物流跟踪接口有什么区别？

（1）接入方式不一样：

即时查询接口，根据快递单号和快递公司编码实时查询物流轨迹信息。

物流跟踪接口，用户订阅快递号，快递鸟系统会定时推送新的物流信息。

（2）实现的功能不一样：

即时查询接口，单次请求只能查询一个单的物流信息，支持10次/S的并发请求。

物流跟踪接口，订阅推送的模式获取轨迹信息，发起一次订阅后，快递鸟会持续监控推送更新的轨迹信息，直到签收。

（3）查询单量不一样：

即时查询每日查询次数<=3000次，物流跟踪不限制订阅单量，并可一直获得每个单号的更新信息。

6、问题： 快递鸟物流跟踪数据的时效性怎样？

在接收到新的快递单后，会立即加入监控队列，有结果的话会即时内返回，没有结果的话，会等待一定时间（如2小时）再进行下一次监控。对于这些后续的监控，如果某运单号在快递公司官网对应的结果B，B最新一条状态所对应的时间为T1，快递鸟将B推送给贵公司的时间为T2，那么|T2-T1|一般在0~2~4 个小时以内，但我方会不断地向贵方进行推送，使运单状态能持续地更新。

7、问题：快递鸟物流跟踪是需要我们自己开发接收接口是吗？

对接物流跟踪接口，你需要开发订阅接口（将单号和快递公司编码订阅给快递鸟。有订阅接口的.net,php和java版本demo，你可以参考下。还有自己开发一个推送接口（接收快递鸟推送的物流轨迹），开发完后登录快递鸟沙箱后台调试推送接口，调试成功后可在沙箱后台自助配置推送接口。

8、问题：快递鸟物流跟踪的推送接口怎么做?

推送接口是用于接收推送的物流信息，推送接口是我们调用你的接口，你只需要接收参数，在沙箱后台配置你的回调地址就行，RequestData中包含应用级参数，即物流轨迹，推送时会推送requestType、requestData和DataSign三个参数（详情看技术文档），您开发一个推送接口接收这三个参数就行。

9、问题：快递鸟的物流跟踪API实现原理是什么？

订阅接口的工作原理是：用户将快递单号订阅给我们，我们即刻加入队列去物流公司官方接口查询，查询有轨迹就给用户推送。如果没有更新数据，两个小时后会再次去物流公司官方接口查询，有新数据就将全量数据推送给用户，如果没有更新数据，两个小时后再重复上述动作，直到运单签收。

,