很多用户因为需要对接物流/快递公司接口,时常会陷入选择服务商的困境,去快递公司官网开放平台对接,这种方式的优点是直接对接官网,缺点是要一家家去对接,周期长,不是大客户不被重视甚至不给对接,后期的维护成本高,要有专门的技术跟进,调整。一家一家快递公司去对接,比较耗时、耗成本,所以一般都会选择集成物流接口服务商。目前市面上主流的快递查询接口有快递鸟、菜鸟等。那么这些接口服务商怎么对接呢?
免费物流快递单号API接口
每个服务商官网都有详细的接入文档,这里不再一一叙述,仅举一个例子。
以快递鸟为例,在快递鸟官网上面注册后,就可以获取API,有专人对接入群,通过联调测试后,就可以完成对接,十分便捷。以下为即时查询API的技术对接参数:
一、接口描述/说明
(1)查询接口支持按照运单号查询(单个查询)。
(2)接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息。
如:EMS物流单号应选择快递公司编码(EMS)查看快递公司编码
(3)返回的物流跟踪信息按照发生的时间升序排列。
(4)接口指令1002。
(5)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):“application/x-www-form-urlencoded;charset=utf-8”。
(6)接口地址:API地址:快递查询接口
请求系统级参数说明:
备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)
二、接口参数
请求内容字段定义:
返回参数定义:
三、示例
请求示例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
}
]
}