快速開始
讀取
編輯前先讀取資源，並按文件提供 expected_version。
寫入
使用 POST 建立支援的資源、PATCH 執行部分更新、DELETE 執行支援的刪除。
回應
重複執行成功操作時，會回傳已保存的結果，不會再次應用變更。
請求標頭與回應標頭
- Idempotency-Key
- 每次資源寫入都要求 Idempotency-Key。 每個邏輯操作生成一個金鑰；重試同一操作時保持金鑰、方法、目標和請求內容一致。
- expected_version
- 價格變更還可能要求產品、價格、變體價格或價格表版本。 如果版本發生變化，請重新讀取並協調更新，不要強行寫入過期資料。
重試策略
- 同一金鑰用於不同請求會產生 idempotency.key_reused。
- 所有示例均使用合成資料；執行前請將識別碼替換為從自己商店取得的值。