首页 > API文档 > 单号识别API
单号识别API
申请API
单号识别API为用户提供单号识别快递公司服务,依托于快递鸟大数据平台,用户提供快递单号,即可实时返回可能的一个或多个快递公司,存在多个快递公司结果的,大数据平台根据可能性、单号量,进行智能排序。
应用场景
(1)PC端、移动端应用或网站应用集成运单物流信息查询功能时,只需要录入单号即可完成查询,无需用户输入快递公司。
(2)电商网站要在快递鸟查询或者订阅运单时,可通过单号识别先行判断物流公司后,再订阅到快递鸟。
功能说明
使用流程
API?#38382;?/td>
一、接口描述/说明
(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
请求系统级?#38382;?#35828;明:
?#38382;?#21517;称类型说明必须要求
RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。R
EBusinessIDString商户ID,请在?#19994;?#26381;务页面查看。R
RequestTypeString请求指令类型:2002R
DataSignString数据内容签名:把(请求内容(未编码)+AppKey)进行MD5?#29992;埽?#28982;后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。R
DataTypeString请求、返回数据类型:只支持JSON格式R
备注:R-必填(Required),O-可选(Optional),C-报文中该?#38382;?#22312;一定条件下可选(Conditional)
二、接口?#38382;?/div>
请求内容字段定义:
?#38382;?#21517;称类型说明是否必须
LogisticCodeString物流单号R
返回?#38382;?#23450;义:
?#38382;?#21517;称类型说明必须要求
EBusinessIDString电商用户IDR
LogisticCodeString物流单号R
SuccessBool成功与否R
CodeInt失败原因O
ShipperShipperCodeString快递公司编码O
ShipperNameString快递公司名称O
三、示例
请求示例 JSON
{
     "LogisticCode": "3967950525457"
  }
返回示例 JSON
{
      "EBusinessID": "1257021",
      "Success": true,
      "LogisticCode": "3967950525457",
      "Shippers": [
              {
                "ShipperCode": "YD",
                "ShipperName": "韵达快递"
              }
            ]
  }
接入流程
demo下载

相关文档与更多帮助?

  • 帮助与文档
    立即获得接入帮助与?#38469;?#25991;档
  • ?#35797;?#19979;载
    获得DEMO与插件下载
  • API文档
    API接口接入?#38382;?#35828;明
30万+
数十万客户的选择
5.8亿次+
?#31449;?#22788;理物流数据?#38382;?/dd>
1450万+
?#31449;?#21315;万订单数据处理
418家+
支持全国418家物流商
在线咨询
商务合作群:
847086973
?#38469;?#23545;接群10:
790953829
?#38469;?#23545;接群11:
844089794
400-9633321
免费获取API
时界门之将军电子游戏