快速开始
读取
编辑前先读取资源,并按文档提供 expected_version。
写入
使用 POST 创建支持的资源、PATCH 执行部分更新、DELETE 执行支持的删除。
响应
重复执行成功操作时,会返回已保存的结果,不会再次应用变更。
请求头与响应头
- Idempotency-Key
- 每次资源写入都要求 Idempotency-Key。 每个逻辑操作生成一个密钥;重试同一操作时保持密钥、方法、目标和请求内容一致。
- expected_version
- 价格变更还可能要求产品、价格、变体价格或价格表版本。 如果版本发生变化,请重新读取并协调更新,不要强行写入过期数据。
重试策略
- 同一密钥用于不同请求会产生 idempotency.key_reused。
- 所有示例均使用合成数据;执行前请将标识符替换为从自己商店获取的值。