国际出库物流追踪 API

GET /v1/fulfillment/shipments/{shipment_id}/tracking — 履约仓 → 海外收件人。

不是 国内代购物流(卖家 → 仓库)。
不是 包裹轨迹(HioBuy 仓内入库时间线)。
不是 发货单详情:详情给的是运单international_trackingshipping_legs[]boxes[].tracking)以及仓库业务 timeline[](创建 / 打包 / 支付)。本接口返回承运商扫描节点,字段形态与详情子集一致。

路径 {shipment_id} 即创建/详情 id(live 为仓库数字主键字符串,如 "115")。仓库也接受 order_sn。沙箱为 sbs_* / sb_shp_*。可选 language 用于沙箱展示文案;仓库请求体只有 { "shipment_id" }

仓库上游:POST /api/gateway-worker/v1/shipments/track。已作废:POST /v1/fulfillment/shipments/logistics/trace

请求

GET /v1/fulfillment/shipments/107/tracking?language=en
Authorization: Bearer <API_KEY>
参数位置必填说明
shipment_idpath发货单 ID
languagequery展示文案(沙箱)。不会写入仓库 body

响应

与详情对齐的子集:idorder_snshipping_channelinternational_trackingstatusstatus_labeltimeline[]

{
  "id": "118",
  "order_sn": "JIYUNRI1358",
  "shipping_channel": {
    "code": "CJ-SEA",
    "name": "E-commerce Sea - CJ"
  },
  "international_tracking": {
    "tracking_number": null,
    "carrier": null
  },
  "status": "PENDING",
  "status_label": "待处理",
  "timeline": [
    {
      "code": null,
      "title": "订单已创建",
      "occurred_at": "2026-08-23 11:14:58"
    }
  ],
  "request_id": "req_xxx"
}

字段说明见 履约响应模型

获取支持

需要集成帮助?请联系开发者支持 support@hiobuy.com · 预计 1–2 个工作日内回复

发送邮件