XGD Express 开放平台 开放 API 文档
POST v3 · 稳定版

中马专线轨迹查询接口

查询中国发往马来西亚的物流专线轨迹,返回运单当前状态、最新位置以及完整的轨迹节点列表。支持空运、海运专线包裹的全程追踪。

测试环境 POST https://sandboxapi.xgdexpress.com/v3/trajectory/query
正式环境 POST https://api.xgdexpress.com/v3/trajectory/query
响应格式
JSON
字符编码
UTF-8
超时时间
10s
鉴权方式
Bearer Token

请求参数

请求参数分为 Header 与 Body 两部分,Body 参数需以 JSON 格式提交,字段名区分大小写。Token 需联系我司客服授权获取。

Header 参数

参数名 类型 必填 说明

Body 参数

参数名 类型 必填 说明

请求示例

以下示例展示了一次完整的轨迹查询请求(测试环境地址)。

成功响应

请求成功时返回 HTTP 200,业务码 code 为 0,运单轨迹数据位于 data 字段中。

200 OK

响应字段说明

字段名 类型 说明

失败响应

请求失败时返回对应的 HTTP 状态码,code 为非 0 的业务错误码,data 固定为 null。

400 Bad Request

错误码说明

常见业务错误码与 HTTP 状态码对照表,请根据业务码进行针对性处理。

业务码 HTTP 状态码 说明