Мониторинг API: код 200 — ещё не успех

Самый коварный сбой — 200 с пустым массивом. Клиент получает «успех» и показывает пользователю ничего.

Минимальный набор проверок API: доступность эндпоинта, код ответа, наличие обязательных полей и время ответа. Дальше — по важности: проверка значения поля, схема, авторизация под сервисным токеном.

• Код ответа — 2xx, но не любой: ожидайте конкретный
• Наличие поля: data.items и его длина больше нуля
• Значение: status = "ok", а не просто существование
• Время ответа: p95, а не среднее — среднее прячет хвост
• Авторизация: токен действителен, а не 401 через сутки
• Вебхуки: доставка и повторные попытки

Проверяйте разные сценарии: не только GET списка, но и POST создания в тестовом окружении. Именно POST ловит проблемы с базой, миграциями и правами. И следите за размером ответа: резкое падение означает пустую выборку, резкий рост — дубли или утечку.

Отдельный случай — «зелёный» API, который отдаёт закэшированные данные: код 200, но данные недельной давности. Поэтому в ответ полезно добавлять метку времени и проверять её свежесть.

Частые вопросы