身分驗證
契約已確認 · 驗證中
身分驗證
使用新 Shipbuy 工作台為 V2 API 簽發的 Key，在 X-API-Key 中傳送完整值。App 登入 token 與 V1 JWT 不適用。帳戶、環境和權限由 Key 決定，切換文件版本不會修改它們。獨立出貨須允許 allowStandaloneShipping；限定倉庫時， warehouseId 與 shipFrom 須符合授權倉；僅 warehouses.all 允許任意寄件位址。無店鋪關聯業務需 stores.all，未分倉履約需 allowUnassignedFulfillments，純 standalone 不額外要求這兩項。
Content-Type: application/json X-API-Key: <your-v2-api-key>管理 V2 API Key
串接說明
建立或輪換後，完整 Key 只顯示一次，請保存到伺服器端安全設定。預設效期 365 天，可明確選擇永久；支援暫停、撤銷和輪換。輪換預設重疊 24 小時，最長 7 天。測試資料在 Settings → Developer → Sandbox 管理；正式能力以本頁操作開放狀態為準。
V2 寫入命令需要 Idempotency-Key，PATCH 另需 If-Match。結果不明時重試須保留相同冪等鍵、內容與首次 If-Match。ID 與金額為字串，日期時間為 UTC；報價期限、業務條件和組合權限仍須符合。