Перейти к содержимому
Антон ГончаровРазработчик ИИ-систем

1 минута чтенияСделать за вечер

Сделать за вечер: сигнализация на изменения API

Сделать за вечер: сигнализация на изменения API

API часто ломается не с ошибкой, а «тихо»: поле переименовали, вложенный объект стал null, список внезапно пустой. Клиент узнаёт об этом раньше вас.

За вечер можно собрать маленький проверяльщик JSON-ответов по снимкам.

1. Выберите 3–5 критичных запросов: авторизация, карточка сущности, создание заказа, список данных.

2. Сохраните успешные ответы как эталоны в папку snapshots/. Секреты и персональные данные заранее вырежьте.

3. Скрипт делает запросы и сравнивает не значения, а форму ответа: ключи, типы, обязательные вложенные поля. Например: assert set(actual) == set(expected)

4. В отчёт выводите только различия: «пропало поле», «ожидалась строка, пришёл null», «изменился тип».

5. Запускайте его перед деплоем или по расписанию.

Это не замена контрактным тестам. Зато это дешёвый датчик дыма: он быстро замечает изменения, которые легко пропустить глазами в JSON на пару экранов.

Обсудить в канале
Сделать за вечер: сигнализация на изменения API