即时查询API

来源：互联网发布：软件退税计算公式编辑：程序博客网时间：2024/06/05 15:10

即时查询API

物流查询API提供实时查询物流轨迹的服务，用户提供运单号和快递公司，即可查询当前时刻的最新物流轨迹。

应用场景

（1）电商网站用户打开“我的订单”时调用此API显示物流信息详情。
（2）电商管理后台的物流系统，客服在对账前查询所有运单的签收状态，并追踪问题。
（3）每日调用次数限制不超过3000次，如超过该限制，请对接物流跟踪API。
（4）全流程的物流状态跟踪，即时查询无限次，请对接在途监控API。

功能说明

使用流程

API参数

一、接口描述/说明

（1）查询接口支持按照运单号查询(单个查询)。
（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）返回的物流跟踪信息按照发生的时间升序排列。
（4）接口指令1002。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）接口地址： API地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx

请求系统级参数说明：

参数名称类型说明必须要求RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。REBusinessIDString商户ID，请在我的服务页面查看。RRequestTypeString请求指令类型：1002RDataSignString数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo。RDataTypeString请求、返回数据类型：2-json；O

备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）

二、接口参数

请求内容字段定义：

参数名称类型说明必须要求OrderCodeString订单编号OShipperCodeString快递公司编码RLogisticCodeString物流单号R

返回参数定义：

参数名称类型说明必须要求EBusinessIDString用户IDROrderCodeString订单编号OShipperCodeString快递公司编码RLogisticCodeString物流运单号OSuccessBool成功与否RReasonString失败原因OStateString物流状态：2-在途中,3-签收,4-问题件RTracesAcceptTimeString时间RAcceptStationString描述RRemarkString备注O

三、示例

请求示例 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        }        ]        }

接入流程

详情请点击进入快递鸟官网—即时查询APIhttp://www.kdniao.com/api-track

阅读全文

0 0