快递鸟
  1. 即时查询API
快递鸟
  • 电子面单API
    • 应用场景/功能说明/使用流程
    • 电子面单接口
      POST
    • 订单取消接口
      POST
    • 单号余量查询接口
      POST
    • 客户号申请接口
      POST
  • 上门取件API
    • 应用场景/功能说明/使用流程
  • 预约取件API
    • 应用场景/功能说明/使用流程
    • 预约取件接口
      POST
  • 即时查询API
    • 应用场景/功能说明/使用流程
    • 即时查询
      POST
  • 物流跟踪API
    • 应用场景/功能说明/使用流程
    • 2.推送接口(商户实现)
    • 订阅接口
      POST
  • 在途监控API
    • 应用场景/功能说明/使用流程
    • 推送(增值版)接口(商户实现)
    • 即时查询(增值版)接口
      POST
    • 订阅(增值版)接口
      POST
  • 快递查询API
    • 应用场景/功能说明/使用流程
    • 快递查询
      POST
  • 物流轨迹地图API
    • 应用场景/功能说明/使用流程
    • 推送(轨迹地图版)接口(商户实现)
    • 即时查询(轨迹地图版)
      POST
    • 订阅(轨迹地图版)
      POST
  • 物流短信API
    • 应用场景/功能说明/物流短信
    • 设置短信模板
  • 单号识别API
    • 应用场景/功能说明/使用流程
    • 单号识别API
  • 智能地址解析API
    • 应用场景/功能说明
    • 智能地址解析API
  1. 即时查询API

即时查询

POST
/EbusinessOrderHandle.aspx
(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)正式地址:https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://prod-cn.your-api-server.com/EbusinessOrderHandle.aspx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "RequestData": "string",
    "EBusinessID": "string",
    "RequestType": "string",
    "DataSign": "string",
    "DataType": "string",
    "OrderCode": "string",
    "ShipperCode": "string",
    "LogisticCode": "string"
}'
响应示例响应示例
成功示例(有物流轨迹)
{
  "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
    }
  ]
}

请求参数

Body 参数application/json
RequestData
string 
必需
请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。
EBusinessID
string 
必需
商户ID,请在我的服务页面查看。
RequestType
string 
必需
请求指令类型:1007
DataSign
string 
必需
数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。
DataType
string 
可选
请求、返回数据类型:只支持JSON格式
OrderCode
string 
订单编号
可选
ShipperCode
string 
快递公司编码
必需
LogisticCode
string 
物流单号
必需
示例

返回响应

🟢200成功
application/json
Body
EBusinessID
string 
用户ID
必需
OrderCode
string 
订单编号
可选
ShipperCode
string 
快递公司编码
必需
LogisticCode
string 
物流运单号
可选
Success
boolean 
成功与否
必需
State
integer 
必需
物流状态:2-在途中,3-签收,4-问题件
Reason
null 
失败原因
必需
Traces
array [object {3}] 
必需
AcceptTime
string 
时间
必需
AcceptStation
string 
描述
必需
Remark
null 
备注
必需
上一页
应用场景/功能说明/使用流程
下一页
应用场景/功能说明/使用流程
Built with