身份验证
契约已确认 · 验证中
身份验证
使用新 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；报价期限、业务条件和组合权限仍需满足。