🔒Открыть пост
и посмотреть медиа
и посмотреть медиа
ИДЕМПОТЕНТНОСТЬ В API: ЗАЧЕМ НУЖНА И КАК ПРОТЕСТИРОВАТЬ РУКАМИ
Всем привет!
Сегодня хочу поговорить о понятии, которое часто встречается в спецификациях API, но не всегда понятно тестировщику без технического бэкграунда. Речь про идемпотентность.
Идемпотентность - это свойство операции, при котором повторный вызов метода даёт тот же результат, что и первый.
Простой пример из жизни: выключатель света. Если он уже выключен, то сколько бы вы ни жали «выкл», то лампочка останется все равно погашенной.
В API это важно, потому что запросы в реальной жизни могут теряться, дублироваться или повторяться из-за сетевых проблем. И если каждый повтор будет менять данные, то последствия могут быть серьезными.
Примеры:
⁃ DELETE /user/123 → пользователь удалён. Если вызвать повторно, система должна вернуть «пользователя уже нет», а не падать или создавать что-то новое.
⁃ PUT /user/123 {name: “Александр”} → имя изменилось на Александр. Повторный запрос должен оставить всё как есть.
⁃ А вот POST /order обычно не идемпотентен, потому что каждый вызов создаёт новый заказ.
Как тестировать идемпотентность вручную:
1. Найти в документации методы, которые по определению должны быть идемпотентны (чаще всего GET, PUT, DELETE). Кстати иногда разработчики делают и POST идемпотентным (чаще всего через Idempotency-Key), например в платежным системах, так стоит уточнять этот момент.
2. Сделать запрос и зафиксировать результат.
3. Повторить этот же запрос несколько раз.
4. Проверить, что состояние системы не меняется после первого успешного вызова.
5. Дополнительно проверить логи и базу (если есть доступ), чтобы убедиться, что дубликатов не появилось.
Почему это важно тестировать?
Потому что при реальных сбоях (например, потеря пакета или таймаут) клиент может отправить один и тот же запрос несколько раз. И именно идемпотентность спасает бизнес от дублирования заказов, списания денег дважды и прочих подобных багов.
Все мои проекты:
TG канал по тестированию AI |
Youtube channel | Практика по тестированию | Платформа TestGrow | Автоматизация тестирования | Курс по тест-менеджменту | База знаний