1.全国快递物流地图轨迹查询接口详解
1.1 接口请求
- 请求方式：POST
- 请求地址：
- 请求头：
标签 | 必填 | 说明 |
|---|---|---|
X-APISpace-Token | 是 | 鉴权私钥，登陆 APISpace 后在管理后台的[访问控制]页面查看 |
Authorization-Type | 是 | 鉴权方式，值为：apikey |
Content-Type | 是 | application/json |
- 请求参数：
参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
cpCode | [string] | 是 | 快递编码 例如圆通:YTO（快递公司编码表可查看介绍页的相关附件） |
mailNo | [string] | 是 | 快递运单号 |
phone | [string] | 是 | 手机号 |
origin | [string] | 是 | 出发地-省市区 |
destination | [string] | 是 | 目的地-省市区 |
receiveAddress | [string] | 是 | 收件详细地址 |
responseModel | [string] | 否 | 返回类型，物流轨迹地图数据:JSON（暂未开放）物流轨迹地图PC链接:PC（暂未开放）物流轨迹地图H5链接:H5。注意：若参数为空则不传该参数，否则会导致签名错误，请求失败 |
1.2 返回参数
名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
traceMapR | [string] | 是 | response Model为PC或H5返回的物流轨迹地图链接 |
success | [boolean] | 是 | 返回成功 |
traceId | [string] | 是 | 请求唯一标识 |
1.3 返回实例
代码语言：javascript复制{
"traceMapR":"https://open.kdzs.com/toolRes/amap?trackMapCode=c03241dc62cd8a2883f743dcbd5319d8",
"success":true,
"traceId":"3365078218826466"
}1.4 地图轨迹实例图
2.全国快递物流地图轨迹查询API产品介绍
APISpace 的 全国快递物流地图轨迹查询，在地图中展示包裹运输轨迹，支持单号的订阅与推送。包括顺丰、圆通、申通等主流快递公司。
- 覆盖 600 主流快递轨迹信息全面，数据精准涵盖范围广。
- 根据用户提交的快递单号，智能判断该单号所属快递公司，智能识别单号接口调用不扣费。
- 基于快递公司单号规则和千万级快递单号大数据，单号识别率超过98%。
- 订阅与推送接口，订阅成功扣费一次，后续物流信息更新推送到回调地址不产生扣费。
订阅后的推送内容示例
代码语言：javascript复制[
{
"cpCode":"EMS",
"mailNo":"9870xxx",
"courier":"林xx",
"takeTime":"4天7小时11分",
"logisticsStatusDesc":"已签收",
"courierPhone":"185xxx",
"logisticsStatus":"SIGN",
"logisticsFullTraceList":[
{
"areaCode":"CN320400000000",
"areaName":"江苏省,常州市",
"subLogisticsStatus":"ACCEPT",
"time":"2023-03-22",
"logisticsStatus":"ACCEPT",
"desc":"【常州市吕汤路包裹揽投部】已收寄,揽投员:创世陈xx,电话:1886xxxx"
}
]
}
]3.全国快递物流地图轨迹查询API应用场景
1.电商平台
可以将该 API 集成到其订单跟踪系统中，以便消费者可以在平台上实时追踪其包裹的物流状态。这可以提高消费者的购物体验，减少与物流相关的客服问题。
2.物流公司
可以将该 API 集成到其物流管理系统中，以便员工可以实时追踪运输货物的位置，并向客户提供实时的物流信息。这可以提高物流公司的服务质量，提高客户满意度。
3.物流服务提供商
可以使用该 API 来跟踪多个货物的位置，并确保这些货物按时到达目的地。这可以提高服务质量，减少货物丢失和损坏的可能性。
4.供应链管理
可以使用该 API 来跟踪产品的运输过程，并确保产品在整个供应链中的准时交付。这可以提高供应链的效率，减少库存和运输成本。
