Початок роботи
Читання
Перед редагуванням прочитайте ресурс і передайте expected_version відповідно до документації.
Запис
Використовуйте POST для створення підтримуваних ресурсів, PATCH для часткових оновлень і DELETE для дозволеного видалення.
Відповідь
Повтор успішної операції повертає збережений результат без повторного застосування змін.
Заголовки
- Idempotency-Key
- Кожен запис ресурсу потребує Idempotency-Key. Створюйте один ключ для кожної логічної операції; повторюючи її, зберігайте той самий ключ, метод, ціль і дані.
- expected_version
- Зміни цін можуть також потребувати версії товару, ціни, ціни варіанта чи прайс-листа. Якщо версія змінилася, прочитайте дані повторно й узгодьте оновлення, не перезаписуючи їх застарілими значеннями.
Правила повторення
- Використання того самого ключа для іншого запиту повертає idempotency.key_reused.
- Усі приклади синтетичні; перед виконанням замініть ідентифікатори значеннями зі свого магазину.