M Express 集成指南

本指南面向接入 M Express 的后端工程师，帮助你选择公开追踪或 Webhook、按契约实现，并在上线前 完成安全验收。

从这里开始

先阅读开始接入。其中说明了推荐的实现顺序、密钥处理原则和上线检查项。

API 地址

所有生产 API 请求均以以下基础地址开头：

https://mexpress.nz/api/v1

https://docs.mexpress.nz 只提供本指南，不是 API 主机。

按需求选择能力

你的产品需要…	从这里开始	访问方式
根据追踪号展示对客户安全的配送状态	追踪 API	匿名访问，返回范围受限
将配送状态变化接收到自己的系统	Webhooks	发送到你接收端的签名请求
为两种能力完成接入与上线检查	开始接入	服务端集成基础

每种能力可以返回什么

公开追踪的范围刻意受限：它只接受 tracking_number，只返回对客户安全的状态投影。响应不会 包含收件人联系方式或地址、包裹扫描码、POD 媒体、精确位置、司机或设备身份、计费、原始扫描、 内部审计或风险字段。

追踪是按需查询；Webhook 是配送变化时向你的接收端发送事件。两者可组合使用：客户界面读取 追踪投影，内部系统通过 Webhook 保持更新。Webhook 必须对未改动的原始请求体验签并安全处理重复 或乱序事件。

从阅读到上线

1. 阅读开始接入，确定生产 API 地址和密钥边界。
2. 按追踪 API或Webhooks实现对应能力。
3. 验证正常、不可用、限流、重复和重试场景。
4. 完成每页的上线检查项。

下一步

从开始接入开始，完成服务端接入的前置准备。