地图轨迹订阅[简]

企业专用个人高级认证支持MCP

订阅订单后,实时推送物流状态信息

¥79.2

立即购买

产品功能
接口文档
示例代码

功能介绍

实时轨迹订阅

输入包裹的运单号，系统将实时追踪并返回包裹的最新位置和运输状态，确保您能够随时了解包裹的动态。

全面覆盖

支持国内外主要快递公司的物流信息查询，无论您的包裹由哪家快递承运，我们的系统都能提供全面的查询服务，满足不同用户的需求。

精准推送

物流信息精准推送，确保您获取的运输状态是最新的。一旦包裹状态发生变化，系统会立即通过您选择的方式通知您，让您随时掌握最新动态。

多渠道通知

系统提供多种通知方式，包括电子邮件、短信和App推送通知，确保您不会错过任何重要的物流更新。

数据安全

采用先进的加密技术，如AES、AES+RSA，确保您的物流信息在传输过程中的安全和保密。

官方渠道

直接连接各大物流公司的官方数据源，确保您获取的信息准确无误，可靠性高。

高准确率

提供高达99.99%的查询准确率，帮助您有效避免因信息错误导致的物流风险。

稳定强大

系统7天24小时持续运行，支持高并发访问，适应各种物流查询需求，确保服务不中断。

应用场景

地图轨迹订阅优化

物流公司使用地图轨迹订阅服务接口，分析运输数据，识别信息推送瓶颈，优化信息推送路线，降低成本，提升服务质量。

供应链协同

供应链企业通过物流信息推送服务接口，实时监控货物运输情况，优化库存管理和物流调度，提高协同效率。

在线客户服务

客户服务提供商可以利用物流信息推送服务接口，为用户提供实时的物流状态更新，增强客户服务体验和满意度。

产品参数

性能

与官方同步

更新频率

查得计费

计费模式

99%

数据覆盖

业务

60QPS

并发连接

平均500ms

回调时长

https/http

支持协议

使用流程

账号注册

点击「免费注册」输入手机号和验证码完成注册

立即注册

开通服务

开通相关的功能服务

查看服务

开发和联调

获取AppKey/AppSecret进行API调用

测试文档

开始使用

开始使用云客通的功能

开始使用

合作客户

服务保障

可靠安全

提供高可用、低延迟的服务，实施严格的安全措施，确保业务的稳定运行和数据安全。

服务专业

专业团队提供全方位的售前和售后服务，随时解决您的疑问和问题。

数据合规

严格遵守数据保护法规，官方直连获取数据，确保数据的合法、合规。

灵活持续

提供多样接口，并持续更新，以满足您不断变化的业务和商业需求。

接口文档

地图轨迹订阅

错误码

错误码列表

物流轨迹推送接口

接口地址: 接口详情请点击

请求方式: post

返回类型: Json

轨迹排序：按照发生时间的降序排列

请求Header:

名称	值
Content-Type	application/x-www-form-urlencoded;charset=utf-8

请求参数说明:

名称	类型	说明
logistics_interface	string	json字符串，各字段含义参见下述说明
nonce	string	1686210870 时间戳（秒）
sign	string	v1版本的签名，如对接v2版本的用户忽略该字段即可
signV2	string	v2版本的签名

logistics_interface参数字段含义说明

名称	类型	描述
subCallBackParam	String	用户自定义的回传字段
cpCode	String	快递公司编码
mailNo	String	运单号
logisticsStatus	String	快递单当前主状态
logisticsStatusDesc	String	快递单当前主状态说明
logisticsStatusEx	String	快递单当前详细状态，若快递公司无详细状态值，此时将返回和logisticsStatus主状态一致的值
logisticsStatusExDesc	String	快递单当前详细状态说明
success	Boolean	是否正常推送，正常:true，异常:false。若为false，lastLogisticDetail、logisticsGmtModified、routeDtos均为null
code	String	响应码
msg	String	推送消息体，正常轨迹更新时不填；轨迹无法推送时，填入不可推送原因
lastLogisticDetail	String	此字段将返回最后一条轨迹信息
logisticsGmtModified	String	此字段将返回最后一条轨迹信息更新时间，格式yyyy-MM-dd HH:mm:ss
city	String	当前运单所在城市
routeDtos	List	此字段将通过json数组形式返回所有轨迹信息
context	String	物流说明内容
time	String	物流发生时间，格式yyyy-MM-dd HH:mm:ss
city	String	当前物流节点所在城市
status	String	当前物流节点运单状态
deliveryMan	String	派件快递员（只有派件节点才会有值）
deliveryManTel	String	派件快递员手机号（只有派件节点才会有值）
receiverAddressLatAndLng	String	收件人地址经纬度，调用订阅轨迹地图接口才会返回数据
receiverAddress	String	收件人地址，调用订阅轨迹地图接口才会返回数据
senderAddressLatAndLng	String	发件人地址经纬度，调用订阅轨迹地图接口才会返回数据
senderAddress	String	发件人地址，调用订阅轨迹接口才会返回数据
routeLatLngs	List	途径城市经纬度，调用订阅轨迹地图接口才会返回数据
latAndLng	String	城市经纬度，调用订阅轨迹接口才会返回数据
location	String	位置，调用订阅轨迹接口才会返回数据
routeMapUrl	String	轨迹URL，调用订阅轨迹地图接口才会返回数据

请求示例:

JSON返回示例：


logistics_interface: {
	"mailNo": "75757205xxxxx",
	"cpCode": "ZTO",
	"logisticsStatus": "10",
	"logisticsStatusDesc": "已签收",
	"lastLogisticDetail": "【昭通市】 您的快递已签收，签收人在【昭通永善红光新区店】取件。如有疑问请联系业务员：18488048730，代理点电话：18488048730，投诉电话：15808611136。感谢使用中通快递，期待再次为您服务！",
	"logisticsGmtModified": "2024-01-17 19:31:43",
	"city": "昭通市",
	"logisticsDeliveryMan": "杨林",
	"logisticsDeliveryManTel": "18488048730",
	"success": true,
	"logisticsStatusEx": "10",
	"logisticsStatusExDesc": "已签收",
	"routeDtos": [{
		"context": "【昭通市】 您的快递已签收，签收人在【昭通永善红光新区店】取件。如有疑问请联系业务员：18488048730，代理点电话：18488048730，投诉电话：15808611136。感谢使用中通快递，期待再次为您服务！",
		"time": "2024-01-17 19:31:43",
		"city": "昭通市",
		"status": "10",
		"deliveryMan": "",
		"deliveryManTel": ""
	}, {
		"context": "【昭通市】 快件已在 快递超市 的【昭通永善红光新区店】暂放，【取件地址：红光新区27栋三号门面】，请及时取件。如有疑问请联系业务员：18488048730，代理点电话：18488048730，投诉电话：15808611136",
		"time": "2024-01-17 10:29:49",
		"city": "昭通市",
		"status": "9-1",
		"deliveryMan": "",
		"deliveryManTel": ""
	}, {
		"context": "【昭通市】昭通永善县 的业务员【杨林,18488048730】正在为您派件（95720为中通快递员外呼专属号码，请放心接听，如有问题可联系网点:0870-8837319、13033375675,投诉电话:15808611136）",
		"time": "2024-01-17 09:13:10",
		"city": "昭通市",
		"status": "9",
		"deliveryMan": "杨林",
		"deliveryManTel": "18488048730"
	}, {
		"context": "【昭通市】 快件已到达 昭通永善县",
		"time": "2024-01-17 09:13:06",
		"city": "昭通市",
		"status": "8",
		"deliveryMan": "",
		"deliveryManTel": ""
	}, {
		"context": "【自贡市】 快件已发往 昭通永善县",
		"time": "2024-01-16 05:41:18",
		"city": "自贡市",
		"status": "8",
		"deliveryMan": "",
		"deliveryManTel": ""
	}, {
		"context": "【自贡市】 快件已到达 自贡转运中心",
		"time": "2024-01-16 05:37:11",
		"city": "自贡市",
		"status": "8",
		"deliveryMan": "",
		"deliveryManTel": ""
	}, {
		"context": "【东莞市】 快件已发往 自贡转运中心",
		"time": "2024-01-15 02:41:32",
		"city": "东莞市",
		"status": "8",
		"deliveryMan": "",
		"deliveryManTel": ""
	}, {
		"context": "【东莞市】 快件已到达 虎门转运中心",
		"time": "2024-01-15 02:40:10",
		"city": "东莞市",
		"status": "8",
		"deliveryMan": "",
		"deliveryManTel": ""
	}, {
		"context": "【深圳市】 快件已发往 自贡转运中心",
		"time": "2024-01-15 00:54:28",
		"city": "深圳市",
		"status": "8",
		"deliveryMan": "",
		"deliveryManTel": ""
	}, {
		"context": "【深圳市】 深圳新福永（0755-36550500）华南佰仓科技（15812902066） 已揽收",
		"time": "2024-01-14 22:09:02",
		"city": "深圳市",
		"status": "7",
		"deliveryMan": "",
		"deliveryManTel": ""
	}],
	"subCallBackParam": "R2401141856435172464336"
},
sign: "fb2462011a85e85aaa93b46b73xxxx",
signV2: "b1d0543ee2fba414609ebe7c7xxxx",
nonce: "1705497746"

响应参数:

字段名称	类型	字段含义
success	Boolean	成功:true 失败:false
code	String	订阅方内部响应码，用于后期问题定位。若接收失败，必填；接收成功可不填
msg	String	接收结果，若接收失败，必填

正确返回示例

JSON返回示例：


{
  "success": true,
  "code": "200",
  "msg": "推送成功"
}

错误返回示例

JSON返回示例：


{
  "success": false,
  "code": "xxx",
  "msg": "xx原因"
}

服务级错误码参照(error_code)：

响应结果

字段含义

success

true	请求成功
false	请求失败

errorCode

201	快递单不存在，请确认运单号或者快递公司是否正确
202	查询顺丰快递请指定手机号后四位
203	服务器繁忙,请稍后再试
204	当前快递公司不支持，请选择正确的快递公司编码
205	订阅失败，请稍后再试
54	请求参数有误，返回详细的错误信息，如必填快递编码参数未传值，则返回“快递公司编码不能为空”
209	调用频繁，请稍后再试
301	回调数据校验错误
302	接口不允许调用
400	接口调用失败
401	运单号未订阅，请先调用订阅接口后再调用此接口
402	subCallBackUrl字段不能为空
403	订阅失败，请检查顺丰手机号或入参是否正确

完整示例代码分享：

	语言	标题	提供者	时间
	java	SubCallbackDemo.java(3 KB)	2020-10-15 13:17:24

地图轨迹订阅[简]

数据驱动未来

Data Drives The Future

立即注册

确认支付

地图轨迹订阅[简]

产品功能

接口文档

示例代码

功能介绍

应用场景

产品参数

使用流程

合作客户

服务保障

物流轨迹推送接口

请求Header:

请求参数说明:

logistics_interface参数字段含义说明

请求示例:

响应参数:

正确返回示例

错误返回示例

推荐API

API资讯