Преминете към съдържанието
ShopentlyLearn

Безопасни записи

Комбинирайте ключовете за идемпотентност с проверки на версията за предвидими промени.

Първи стъпки

  1. Четене

    Прочетете ресурса преди редактиране и подайте expected_version според документацията.

  2. Запис

    Използвайте POST за създаване на поддържани ресурси, PATCH за частични промени и DELETE за поддържани изтривания.

  3. Отговор

    Повторена успешна операция връща съхранения резултат, без да прилага промяната отново.

Заглавки

Idempotency-Key
Всеки запис на ресурс изисква Idempotency-Key. Генерирайте един ключ за всяка логическа операция; при повторение използвайте същите ключ, метод, цел и данни.
expected_version
Промените на цени може да изискват и версии на продукта, цената, цените на варианти или ценовата листа. Ако версията се промени, прочетете отново и съгласувайте промяната, вместо да налагате остарели данни.

Правила за повторение

  • Използването на същия ключ за различна заявка връща idempotency.key_reused.
  • Всички примери са синтетични; заменете идентификаторите със стойности от собствения магазин преди изпълнение.