APISpace 全国快递物流地图轨迹查询API接口案例代码

1.全国快递物流地图轨迹查询接口详解

1.1 接口请求

请求方式：POST
请求地址：https://eolink.o.apispace.com/wldtgj1/paidtobuy_api/trace_map
请求头：

标签	必填	说明
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":"https://open.kdzs.com/toolRes/amap?trackMapCode=c03241dc62cd8a2883f743dcbd5319d8",
    "success":true,
    "traceId":"3365078218826466"
}

1.4 地图轨迹实例图

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