🔒Открыть пост
и посмотреть медиа
и посмотреть медиа
ГОЛЫЕ API БЕЗ ДОКУМЕНТАЦИИ: КАК ТЕСТИРОВЩИК МОЖЕТ ИССЛЕДОВАТЬ ИХ ЧЕРЕЗ NETWORK-ТРАФИК
Всем привет!
Одна из самых частых и болезненных ситуаций для тестировщика, когда есть API, но нет документации. Swagger не завезли, Confluence пустует, разработчик в отпуске, а функционал уже нужно проверять.
Что делать? Сидеть и ждать документацию — плохая стратегия. В реальности тестировщик часто становится исследователем.
С чего начать:
1. Network-трафик
Открываем DevTools - вкладка Network.
Делаем действия в UI и смотрим, какие запросы летят: метод (GET/POST/PUT/DELETE), урлы, тело запроса, коды ответа.
По паттернам можно догадаться, какие эндпоинты за что отвечают.
2. Параметры и тела запросов
Если видим POST /user/login, то по телу запроса легко понять, что нужно: username, password.
Иногда можно заметить лишние поля, которые UI не использует. Это подсказка о скрытом функционале.
3. Коды ответов и ошибки
Даже без документации API подсказывает само:
400 Bad Request - что-то не так в теле запроса.
401 Unauthorized - нужен токен.
404 - эндпоинт не существует или нет доступа.
200/201 - успешные кейсы.
4. Форматы данных
Чаще всего это JSON. Если в ответе приходит объект, можно собрать пример схемы прямо руками.
5. Метод проб и ошибок
Меняем параметры запроса и смотрим реакцию API.
Иногда удаётся найти скрытые поля или дополнительные флаги (например, isAdmin=true).
6. Инструменты-помощники
Экспортируем запрос из DevTools в Postman и гоняем вариации.
Используем Charles/Fiddler, если нужно перехватить и подменить данные на лету.
Такое умение исследовательски подойти к проверке API важно, потому что:
⁃ Тестировщик может начать проверять функционал раньше документации.
⁃ Можно находить баги на стыке: например, UI отправляет 3 параметра, а API ждёт 5.
⁃ Иногда через такие исследования тестировщик находит лишние методы, которые не должны быть доступны пользователю (и это уже критика для команды).
Отсутствие документации - это не тупик. У тестировщика есть инструменты и любопытство, чтобы раскопать API. И чем раньше это сделать, тем быстрее команда поймёт, где у них проблемы и несогласованность.
Все мои проекты:
TG канал по тестированию AI |
Youtube channel | Практика по тестированию | Платформа TestGrow | Автоматизация тестирования | Курс по тест-менеджменту | База знаний