Что такое идемпотентность в контексте HTTP-методов?

Идемпотентность в HTTP-методах

Идемпотентность — это свойство операции, при котором повторное выполнение операции дает тот же результат, что и первое выполнение. Для HTTP это критически важно при тестировании и интеграции.

Определение

Операция идемпотентна, если вызвать её N раз эквивалентно вызвать её один раз. Состояние системы остаётся одинаковым после первого и после повторных вызовов.

Идемпотентные HTTP методы

GET (идемпотентен)

• Получение данных не изменяет состояние
• Вызовов подряд — всегда один результат
• Пример: GET /api/users/123 — просто читает пользователя

PUT (идемпотентен)

• Замена ресурса целиком
• Результат один и тот же, независимо сколько раз вызовешь
• Пример: PUT /api/users/123 с body {"name": "John"} — установит имя John
  • Первый вызов: устанавливает John
  • Второй вызов: снова устанавливает John (состояние не меняется)

DELETE (идемпотентен)

• Удаление ресурса
• Первый вызов удаляет, второй тоже вернёт успех (или 404, но состояние одинаковое)
• Пример: DELETE /api/users/123 — удаляет пользователя
  • Первый вызов: удаляет
  • Второй вызов: пользователь уже удалён (результат эквивалентен)

HEAD (идемпотентен)

• Как GET, но без тела ответа
• Только проверка наличия ресурса

OPTIONS (идемпотентен)

• Получение информации о допустимых методах

НЕ идемпотентные методы

POST (НЕ идемпотентен)

• Создание нового ресурса
• Каждый вызов создаёт новый ресурс
• Пример: POST /api/users — создаёт нового пользователя
  • Первый вызов: создаёт User #1
  • Второй вызов: создаёт User #2 (новый ресурс!)
  • Третий вызов: создаёт User #3

PATCH (может быть не идемпотентен)

• Частичное обновление
• Зависит от операции
• PATCH /api/users/123 {"counter": +1} — НЕ идемпотентен (каждый раз увеличивает)
• PATCH /api/users/123 {"status": "active"} — идемпотентен (устанавливает значение)

Таблица

Практическое применение для QA

Для тестирования:

• Идемпотентные методы можно вызывать многократно без очистки данных
• POST требует чистки БД между тестами (иначе создадутся дубли)
• При тестировании сетевых сбоев нужно проверить, что повтор запроса работает корректно
• Для критичных операций (платежи) нужна идемпотентность — ключ идемпотентности в headers

Идемпотентные ключи: Для POST-запросов, где нужна идемпотентность (платежи, переводы), используется заголовок:

Idempotency-Key: "550e8400-e29b-41d4-a716-446655440000"

Если повторить запрос с тем же ключом — вернётся тот же результат, не создастся дубль.

Вывод

Понимание идемпотентности критично для тестирования API, проверки обработки ошибок сети и обеспечения надёжности системы.