更新日志
v1 只做新增:新字段、新事件类型、新错误代码。已有的字段不会改名或删除;如确需变更,我们会发布新版本,并提前在此公告。
2026 年 11 月
Section titled “2026 年 11 月”订单接口。
POST /v1/orders、PATCH /v1/orders/{id}、GET /v1/orders/{id}:下空运进口订单、修改订单和查询订单。见订单。POST /v1/orders/validate:只校验订单,不保存。POST /v1/files:上传下单模板和其他附件。- 新增权限
orders:write。新增错误代码order_invalid、order_exists、conflict、too_large、busy。 - 错误响应可带
errors,逐条列出问题。
首次发布。
GET /v1/shipments、GET /v1/shipments/{id}:查询您的空运货物,包括当前阶段、各节点及时间、扣货状态和尾程渠道明细。GET /v1/events:查询货物的每一次更新。- Webhook:同样的事件推送到您的地址,按 Standard Webhooks 规范签名。
ga_live_…密钥、Problem Details 格式的错误响应、每个响应都带Request-Id。