快递单号物流查询自动识别接口【快递鸟API通用教程】

快递单号查询自动识别API提供快递单号自动识别快递物流公司,支持顺丰、中通、圆通、圆通、韵达、百世、邮政、EMS快递单号自动识别，只需快递单号，即可查询418家国内外快递物流轨迹。

单号识别API为用户提供单号识别快递公司服务，依托于快递鸟大数据平台，用户提供快递单号，即可实时返回可能的一个或多个快递公司，存在多个快递公司结果的，大数据平台根据可能性、单号量，进行智能排序。

API参数
一、接口描述/说明
（1）该接口仅对运单号做出识别，识别可能属于的一家或多家快递公司。
（2）接口并不返回物流轨迹，用户可结合即时查询接口和订阅查询接口完成轨迹查询、订阅的动作。
（3）接口识别会返回一家或者多家快递公司，返回的数据根据快递鸟大数据分析结果排序，排名靠前的命中率更高。
（4）若识别失败，快递鸟返回的匹配结果为空。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)：“application/x-www-form-urlencoded;charset=utf-8”。
（6）接口地址： API测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址：http://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx

备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）
二、接口参数
请求内容字段定义：
参数名称类型说明是否必须LogisticCodeString物流单号R
返回参数定义：
参数名称类型说明必须要求EBusinessIDString电商用户IDRLogisticCodeString物流单号RSuccessBool成功与否RCodeInt失败原因OShipperShipperCodeString快递公司编码OShipperNameString快递公司名称O
三、示例
请求示例 JSON

{      "LogisticCode": "3967950525457"   }

返回示例 JSON

{
      "EBusinessID": "1257021",
      "Success": true,
      "LogisticCode": "3967950525457",
      "Shippers": [
              {
                "ShipperCode": "YD",
                "ShipperName": "韵达快递"
              }
            ]
  }

demo下载地址：
接口接入技术文档
点击获取文档
单号识别接口Demo工具.NET版
单号识别接口Demo工具.PHP版
单号识别接口Demo工具.JAVA版

接入流程

1、登录快递鸟官网注册页面注册快递鸟账号

网址：快递单号查询接口_电子面单_APIKey授权申请-快递鸟账号注册

2、登录快递鸟用户管理后台

网址：用户登录_快递鸟API让物流接口对接更简单

注：登录快递鸟用户管理后台后获得用户ID和APIKey，此用于保证应用来源的可靠性，避免应用伪造，被不法使用。

3、进入“我的会员中心”进行实名认证

注：

3.1、认证类型、应用类型根据用户实际情况选择即可，接口返回数据与选择结果无关；

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

3.3、技术对接人信息为用户方对接工程师的信息；

3.4、如有其他疑问可进入官网加入商务合作群进行咨询。

认证成功后，进入“产品服务管理”，开通相关会员服务

注：

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

4、单号识别接口对接重点说明（RequestType：2002）

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

接口开发可以下载“快递鸟接口技术文档”进行参考；单号识别，参考技术文档中的4.4部分；

接口开发可以下载“单号识别demo”进行参考（仅提供了.NET、Java、PHP三种语言的demo）；使用其他语言开发的用户需按照技术文档自行开发；

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

注：快递鸟官网-帮助与文档地址（http://www.kdniao.com/documents）