国际出库物流追踪 API
GET /v1/fulfillment/shipments/{shipment_id}/tracking — 履约仓 → 海外收件人。
不是 国内代购物流(卖家 → 仓库)。
不是 包裹轨迹(HioBuy 仓内入库时间线)。
不是 发货单详情:详情给的是运单号(international_tracking、shipping_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_id | path | 是 | 发货单 ID |
language | query | 否 | 展示文案(沙箱)。不会写入仓库 body |
响应
与详情对齐的子集:id、order_sn、shipping_channel、international_tracking、status、status_label、timeline[]。
{
"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 个工作日内回复