Глосарій

Ідемпотентність

Ідемпотентна операція — та, яку можна виконати кілька разів, і результат буде той самий, що й після першого виконання. Критично важлива в API і чергах, де запит може бути повторений через мережеву помилку.

В HTTP

Ідемпотентні: GET, PUT, DELETE, HEAD — можна повторювати безпечно
Не ідемпотентний: POST — кожен виклик створює новий ресурс

Idempotency Key

Для POST-запитів клієнт генерує унікальний ключ (Idempotency-Key: uuid) і надсилає його в заголовку. Сервер зберігає результат за цим ключем: якщо прийде повторний запит — поверне збережений результат без повторної обробки. Stripe, Twilio та інші платіжні API вимагають цього.

В чергах

Воркер повинен бути готовий отримати одне і те саме повідомлення двічі (at-least-once delivery). Зберігайте оброблені ID і перевіряйте перед обробкою.