跳至内容
ShopentlyLearn

安全写入

结合幂等键和版本检查,实现可预期的更新。

快速开始

  1. 读取

    编辑前先读取资源,并按文档提供 expected_version。

  2. 写入

    使用 POST 创建支持的资源、PATCH 执行部分更新、DELETE 执行支持的删除。

  3. 响应

    重复执行成功操作时,会返回已保存的结果,不会再次应用变更。

请求头与响应头

Idempotency-Key
每次资源写入都要求 Idempotency-Key。 每个逻辑操作生成一个密钥;重试同一操作时保持密钥、方法、目标和请求内容一致。
expected_version
价格变更还可能要求产品、价格、变体价格或价格表版本。 如果版本发生变化,请重新读取并协调更新,不要强行写入过期数据。

重试策略

  • 同一密钥用于不同请求会产生 idempotency.key_reused。
  • 所有示例均使用合成数据;执行前请将标识符替换为从自己商店获取的值。