Что такое идемпотентность и зачем она нужна в API?

Что означает идемпотентность (idempotentness)?

• понятие из областей математики и информатики
• многократное выполнение операции возвращает тот же результат
• в API повторная отправка запроса не должна дополнительно изменять состояние системы
• к идемпотентным HTTP-методам относятся GET, PUT, DELETE
• свойство необходимо для повышения надёжности и отказоустойчивости систем
• позволяет проще организовать повторы запросов и обработку сбоев в распределённых системах
• предотвращает нежелательные побочные эффекты при повторном выполнении действий

Подробный ответ

Основной ответ

Идемпотентность означает, что повторное выполнение одной и той же операции любое количество раз приводит к тому же результату, что и её однократный запуск. В программировании и системах это свойство показывает: повторный вызов команды или запроса не вносит дополнительных изменений в состояние системы и не вызывает ошибок.

Ключевые моменты

• В HTTP: методы GET, PUT и DELETE относятся к идемпотентным, поэтому один и тот же запрос можно безопасно отправить повторно. Например, несколько одинаковых DELETE не приведут к повреждению ресурса.
• В микросервисах и интеграции: идемпотентность особенно важна при сетевых сбоях и повторной отправке запросов, когда система не может гарантировать доставку сообщения.
• Отличие от мутабельных операций: операции, при каждом вызове изменяющие состояние новым образом, не являются идемпотентными. Типичный пример — POST, применяемый для создания ресурса.

Практический контекст

Идемпотентность даёт возможность безопасно реализовать retry-механизмы, не создавая дубликаты данных и дополнительные побочные эффекты. В REST API она уменьшает число ошибок при нестабильном соединении, а в распределённых системах способствует сохранению консистентности данных. Для реализации этого свойства часто применяют уникальные request ID и проверяют, обрабатывался ли запрос ранее.