Postman и Swagger: мой подход к API

За 10 лет в QA я перепробовала много инструментов. И знаете что? Мой любимчик - Postman. А Swagger для меня в первую очередь справочник. Полезный, но для регулярных проверок я выбираю другое. 😄

Когда Swagger, а когда Postman.

Swagger UI удобен, когда нужно изучить API: посмотреть доступные методы, параметры, формат запроса и возможные ответы сервера. Быстро разобраться, что и как работает.

Но если запросы приходится повторять регулярно, мне удобнее Postman. Сохранил запрос, настроил нужные параметры - и не нужно каждый раз собирать все заново. А если немного автоматизировать рутину, становится еще приятнее.

Моя любимая настройка - авторизация.

Есть отдельный запрос на получение токена. После выполнения токен сохраняется в переменную, а последующие запросы используют его автоматически.

Можно также настроить генерацию UUID, проверки кода ответа и наличия нужных параметров. А запросы выполнять последовательно - в том порядке, который нужен для проверки сценария.

В итоге меньше ручных действий и меньше шансов забыть какую-нибудь мелочь. 💪

Как я организую коллекции?

Сначала делю по проектам, затем по функциональности. Внутри - запросы по отдельным функциям. Через полгода открываешь коллекцию и не играешь в квест «А где же тот самый запрос?».

На одном из проектов мы даже повторили структуру Swagger. Получилось удобно: смотришь описание метода - и понимаешь, где искать соответствующий запрос в Postman.

Коллеги отдельно отмечали, что тесты удобно разделены по группам, а авторизация настроена один раз и используется в последующих запросах. Приятно, когда небольшая настройка экономит время всей команде.

Что раздражает?

Иногда Postman перестает работать из-за блокировок. А после обновлений интерфейс меняется так, что нужную кнопку приходится искать заново. Только привыкнешь - и снова знакомство с приложением. 😅

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

А Postman просто помогает делать это удобнее.

А вы для регулярных проверок API что выбираете - Postman, Swagger UI или что-то другое?