站点介绍
零售电商在线网络购物平台及ISV卖家对物流api接口的要求有很多，今天我们主要共享的就是快递鸟快递单号查询接口的对接指南，快递单号查询接口对接的应用场景有很多，很多场景会碰到，最主要的就是电商网址玩家打开“我的订单”时调用此API展现物流消息详情，电商管理后台的物流系统，客服在对账前查询任何运单的签收情况，并跟踪问题，电商在线网络购物平台对卖家物流管控，门槛一定在多少时间快递一定发出要观看到的揽件情况，多少时间一定收到货物观看到的签收情况，根据这些情况对卖家管控从而提升玩家的全体满意度。
调用快递鸟快递单号查询API接口，就能查询到600家以上快递集团单号从收件、运输，到转运中心，派送到签收等各个环节的物流发货情况。快递鸟api接口不区分研究语言，接受java，C#，PHP，Python，ObjectC等研究语言的程序调用。
下面详细教学实现过程：
对接使用流程
1、将快递单号和快递集团编码发送給快递鸟
2、快递鸟根据单号和快递集团查询到物流轨迹情况
3、快递鸟将查询到的物流轨迹情况建议給电商在线网络购物平台或ISV服务商
4、电商在线网络购物平台或ISV服务商接收资料并24小时处理做资料展示或应用
接口描述说明
（1）查询接口接受根据运单号查询(单个查询)。
（2）接口需要指定快递单号的快递集团编码，格式不对或则编码错误都会返失败的消息。
如：EMS物流单号应选择快递集团编码（EMS）调查安装快递鸟快递集团编码
（3）返回的物流跟踪消息根据发生的时光升序排列。
（4）接口指令1002。
（5）接口接受的信息接收方法为
（8）返回类别：jsON
（9）调试页面：
（10）调试工具：去调试（使用快递鸟账号登录）
请求系统级参数说明：
备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）
【接口参数】
请求内容字段定义：
返回参数定义：
示例请求示例 JSON
{ "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118650888018" }返回示例 JSON
没有物流轨迹的 { "EBusinessID": "1109259", "Traces": [], "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118461988807", "Success": false, "Reason": null } 有物流轨迹的 { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118461988807", "Success": true, "State": 3, "Reason": null, "Traces": [ { "AcceptTime": "2014/06/25 08:05:37", "AcceptStation": "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]", "Remark": null }, { "AcceptTime": "2014/06/25 04:01:28", "AcceptStation": "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]", "Remark": null }, { "AcceptTime": "2014/06/25 01:41:06", "AcceptStation": "快件在 深圳集散中心 [深圳市]", "Remark": null }, { "AcceptTime": "2014/06/24 20:18:58", "AcceptStation": "已收件[深圳市]", "Remark": null }, { "AcceptTime": "2014/06/24 20:55:28", "AcceptStation": "快件在 深圳 ,准备送往下一站 深圳集散中心 [深圳市]", "Remark": null }, { "AcceptTime": "2014/06/25 10:23:03", "AcceptStation": "派件已签收[深圳市]", "Remark": null }, { "AcceptTime": "2014/06/25 10:23:03", "AcceptStation": "签收人是：已签收[深圳市]", "Remark": null } ] }前期准备事情去快递鸟官方网站不要钱注册一个账号，不要钱获取一个apiKey(接口权限验证需要)，完成实名身份认证流程，订购一个不要钱或收费付钱套餐（也可找快递鸟事情人员不要钱申请收费付钱的接口测试联调）
快递鸟技术研究文档安装快递鸟DEMO安装
注：登录快递鸟玩家管理后台后获取玩家ID和APIKey对应各demo中的EBusinessID、软件Key。
小知识：EBusinessID跟APIKey是什么？EBusinessID跟APIKey您在快递鸟网址注册之后快递鸟分配的密钥（对应官方网站上的玩家ID和API key），用来保证应用来源的可靠性，避免应用伪造，被不法使用。
请求完全报文（示例）RequestData=%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27JTSD%27%2c%27LogisticCode%27%3a%27jt0000052600488%27%7d&EBusinessID=1264783&RequestType=1002&DataSign=MTYyMDU4NWQ2NmU1ZDI2MDEzNGE5YmVlM2YxYzEzMTM%3d&DataType=2成功返回报文（示例）{"LogisticCode": "JT0000052600488","ShipperCode": "JTSD","Traces": [{"AcceptStation": "【芜湖市】【芜湖镜湖网点】的邓拥军 17855364213已取件","AcceptTime": "2021-03-16 16:26:13"},{"AcceptStation": "【芜湖市】【芜湖镜湖网点】的邓拥军 17855364213已取件","AcceptTime": "2021-03-16 16:41:33"},{"AcceptStation": "【芜湖市】【芜湖镜湖网点】已收件","AcceptTime": "2021-03-16 17:39:21"},{"AcceptStation": "【芜湖市】快件离开【芜湖镜湖网点】已发往【芜湖转运中心】","AcceptTime": "2021-03-16 17:40:27"},{"AcceptStation": "【芜湖市】快件到达【芜湖转运中心】","AcceptTime": "2021-03-16 19:36:32"},{"AcceptStation": "【芜湖市】快件离开【芜湖转运中心】已发往【合肥转运中心】","AcceptTime": "2021-03-16 20:47:03"},{"AcceptStation": "【合肥市】快件到达【合肥转运中心】","AcceptTime": "2021-03-16 23:40:10"},{"AcceptStation": "【合肥市】快件离开【合肥转运中心】已发往【广州花都转运中心】","AcceptTime": "2021-03-17 00:10:48"},{"AcceptStation": "【广州市】快件到达【广州花都转运中心】","AcceptTime": "2021-03-17 20:45:00"},{"AcceptStation": "【广州市】快件离开【广州花都转运中心】已发往【深圳宝安转运中心】","AcceptTime": "2021-03-18 00:17:55"},{"AcceptStation": "【深圳市】快件到达【深圳宝安转运中心】","AcceptTime": "2021-03-18 03:00:17"},{"AcceptStation": "【深圳市】快件离开【深圳宝安转运中心】已发往【深圳福田网点】","AcceptTime": "2021-03-18 04:44:39"},{"AcceptStation": "【深圳市】【深圳福田网点】的邹俊林 17679495647正在派件","AcceptTime": "2021-03-18 08:10:09"},{"AcceptStation": "【深圳市】【深圳福田网点】的赵凯 15919817730正在派件","AcceptTime": "2021-03-18 09:55:19"},{"AcceptStation": "【深圳市】快件已签收，签收人是【代收】，如有疑问请联系：15919817730，期待再一次为您服务","AcceptTime": "2021-03-18 14:53:54"}],"State": "3","EBusinessID": "1264783","Success": true}失败返回报文（示例）{"LogisticCode": "JT0000052600488","ShipperCode": "JTSD","Traces": [],"State": "0","EBusinessID": "1264783","Reason": "业务错误[没有可用套餐]","Success": false}说明：未实名身份认证，未订购套餐，套餐可用查询量已经用完 都会返回此报文消息去实名身份认证/ 知道套餐详情
无轨迹返回报文（示例）{"LogisticCode": "JT0000052600488","ShipperCode": "JTSD","Traces": [],"State": "0","EBusinessID": "1264783","Reason": "暂无轨迹消息","Success": true}分步教学（C#版本）请求资料包结构
C#调用代码示例//电商IDstring eEBusinessID = "test1617571" //电商加密私钥，快递鸟提供，小心保管，不要泄漏string appKey= "554343b2-7252-439b-b4eb-1af42c8f2175" //请求urlstring reqURL = "; }快递单号查询接口应用效果
完成可以达到快递官方网站的展现效果。
关于签名快递鸟和第三方电子网络商务集团系统进行对接，有一定的安全机制。选用 IP 认证加签名 的方法对接，详细方案如下：
以免资料被篡改 在 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 编码)，生成摘要，比较两者的摘要是否相同，如果不一样，说明传递过程中发生资料篡改。
调用接口的身份认证 注册变成快递鸟玩家后，会生成对应的玩家 ID 和 APIKey，玩家 ID 等于玩家名， APIKey 等于密码。
13.返回码定义
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、问题：快递鸟资料更新24小时性怎么样？
立即查询接口：24小时获得目前最新轨迹消息，资料与官方网站消息一致。
物流跟踪接口：快递鸟每2钟头到快递集团获得轨迹，如果您订阅的单号没有轨迹更新，间隔2钟头后再一次到快递集团获得轨迹，依次循环直到有物流轨迹更新，获得到新轨迹后进行排队序列推送。
4、问题：快递鸟资料准确性，会不会存在物流情况不准确的问题？
轨迹消息准确度大于99.9%。物流轨迹消息坚持与快递集团官方网站一致，偶尔存在快递集团提供的接口资料与官方网站不一致的状态，不一致状态小于0.1%。
5、问题：快递鸟立即查询接口和物流跟踪接口有什么区别？
（1）接入方法不一样：
立即查询接口，根据快递单号和快递集团编码24小时查询物流轨迹消息。
物流跟踪接口，玩家订阅快递号，快递鸟系统会定时推送新的物流消息。
（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实现原理是什么？
订阅接口的事情原理是：玩家将快递单号订阅给我们，我们即刻加入队列去物流集团官网接口查询，查询有轨迹就给玩家推送。如果没有更新资料，两个钟头后会再一次去物流集团官网接口查询，有新资料就将全量资料推送给玩家，如果没有更新资料，两个钟头后再重复上述动作，直到运单签收。
10、问题：快递鸟接受哪些快递物流集团查询接口？
快递鸟接受600家以上快递物流集团的接口，详细在快递鸟官方网站安装《快递鸟接口接受快递集团编码.xlsx》调查。
快递鸟是中华领先的物流消息服务商，国家高新技术企业，已先后完成四轮融资，一直专门把注意力集中于企业级物流API技术研发和打通物流各节点消息服务，致力于变成全世界最重要的物流消息枢纽中心，目前接受600 以上快递物流集团接口只能用一次的对接，为企业级玩家提供标准的物流接口和电商物流模块全体解决问题方案，各零售平台商只要简单的对接，就具备了完全的物流服务力量。
相似站点
