請使用 POST 請求,並設定:
Content-Type:application/json
Headers:
X-API-Key、X-API-Timestamp、X-API-Signature
簽名方式:
HMAC-SHA256(secret, timestamp + "\n" + raw_body)
倉庫(可選): 若同一 unique_sku 在多個倉庫都有庫存,請在每筆加入
warehouse_id 以指向正確倉庫;否則當該 SKU 命中多筆時,API 會回覆
duplicate unique_sku 並跳過更新。
[
// 單倉或不分倉 → 可不帶 warehouse_id
{ "code": "A001", "qty": 28103 },
{ "code": "A002", "qty": 66666, "warehouse_id":1 }
// 多倉情境 → 建議帶 warehouse_id
]
以下範例示範如何以 HMAC-SHA256 簽名方式發送請求。
{
"ok": true,
"status": 200,
"message": "OK",
"timestamp": "2025-10-24T10:35:00+08:00",
"data": {
"store_id": 1536,
"processed": 2,
"updated_count": 2,
"no_change_count": 0,
"not_found_count": 0,
"updated": [
{"unique_sku":"A001","old_qty":10,"new_qty":20,"diff":10,"new_cost":0},
{"unique_sku":"A002","old_qty":5,"new_qty":7,"diff":2,"new_cost":0}
],
"no_change": [],
"not_found": [],
"errors": []
}
}
成功時回傳 status=200。若部分項目被跳過或出錯(例如 duplicate unique_sku、not_found),
會回 status=207(Multi-Status),並在 data.errors / data.not_found 顯示詳情。
{
"ok": true,
"status": 207,
"message": "OK",
"timestamp": "2025-10-24T10:35:00+08:00",
"data": {
"store_id": 1536,
"processed": 2,
"updated_count": 0,
"no_change_count": 0,
"not_found_count": 0,
"updated": [],
"no_change": [],
"not_found": [],
"errors": [
{"index":0,"code":"-RE-640","error":"duplicate unique_sku","hint":"provide warehouse_id to disambiguate"},
{"index":1,"code":"6901236342145","error":"duplicate unique_sku","hint":"provide warehouse_id to disambiguate"}
]
}
}
