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 返回实例

{    "traceMapR":";,    "success":true,    "traceId":"3365078218826466"}

2.全国快递物流地图轨迹查询API产品介绍

APISpace 的 全国快递物流地图轨迹查询，在地图中展示包裹运输轨迹，支持单号的订阅与推送。包括顺丰、圆通、申通等主流快递公司。

覆盖 600+ 主流快递轨迹信息全面，数据精准涵盖范围广。根据用户提交的快递单号，智能判断该单号所属快递公司，智能识别单号接口调用不扣费。基于快递公司单号规则和千万级快递单号大数据，单号识别率超过98%。订阅与推送接口，订阅成功扣费一次，后续物流信息更新推送到回调地址不产生扣费。

订阅后的推送内容示例

[    {        "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 来跟踪产品的运输过程，并确保产品在整个供应链中的准时交付。这可以提高供应链的效率，减少库存和运输成本。