首页 > API文档 > 单号识别API
单号识别API
申请API
单号识别API为用户提供单号识别快递公司服务,依托于快递鸟大数据平台,用户提供快递单号,即可实时返回可能的一个或多个快递公司,存在多个快递公司结果的,大数据平台根据可能性、单号量,进行智能排序。
应用场景
(1)PC端、移动端应用或网站应用集成运单物流信息查询功能时,只需要录入单号即可完成查询,无需用户输入快递公司。
(2)电商网站要在快递鸟查询或者订阅运单时,可通过单号识别先行判断物流公司后,再订阅到快递鸟。
功能说明
使用流程
API参数
一、接口描述/说明
(1)该接口仅对运单号做出识别,识别可能属于的一家或多家快递公司。
(2)接口并不返回物流轨迹,用户可结合即时查询接口和订阅查询接口完成轨迹查询、订阅的动作。
(3)接口识别会返回一家或者多家快递公司,返回的数据根据快递鸟大数据分析结果排序,排名靠前的命中率更高。
(4)若识别失败,快递鸟返回的匹配结果为空。
(5)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"
(6)接口地址: API测试地址:http://testapi.kdniao.cc:8081/Ebusiness/EbusinessOrderHandle.aspx
API正式地址:http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx
请求系统级参数说明:
参数名称 类型 说明 必须要求
RequestData String 请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。 R
EBusinessID String 商户ID,请在我的服务页面查看。 R
RequestType String 请求指令类型:2002 R
DataSign String 数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。 R
DataType String 请求、返回数据类型:只支持JSON格式 R
备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)
二、接口参数
请求内容字段定义:
参数名称 类型 说明 是否必须
LogisticCode String 物流单号 R
返回参数定义:
参数名称 类型 说明 必须要求
EBusinessID String 电商用户ID R
LogisticCode String 物流单号 R
Success Bool 成功与否 R
Code Int 失败原因 O
Shipper ShipperCode String 快递公司编码 O
ShipperName String 快递公司名称 O
三、示例
请求示例 JSON
{
     "LogisticCode": "3967950525457"
  }
    
返回示例 JSON
{
      "EBusinessID": "1257021",
      "Success": true,
      "LogisticCode": "3967950525457",
      "Shippers": [
              {
                "ShipperCode": "YD",
                "ShipperName": "韵达快递"
              }
            ]
  }
    
接入流程
demo下载

相关文档与更多帮助?

30万+
数十万客户的选择
5.8亿次+
日均处理物流数据次数
1450万+
日均千万订单数据处理
418家+
支持全国418家物流商
在线咨询
商务合作群:
526574204
技术对接群:
620453345
400-9633321
免费获取API