Postman и Swagger: мой подход к API
За 10 лет в QA я перепробовала много инструментов. И знаете что? Мой любимчик - Postman. А Swagger для меня в первую очередь справочник. Полезный, но для регулярных проверок я выбираю другое. 😄
Когда Swagger, а когда Postman.
Swagger UI удобен, когда нужно изучить API: посмотреть доступные методы, параметры, формат запроса и возможные ответы сервера. Быстро разобраться, что и как работает.
Но если запросы приходится повторять регулярно, мне удобнее Postman. Сохранил запрос, настроил нужные параметры - и не нужно каждый раз собирать все заново. А если немного автоматизировать рутину, становится еще приятнее.
Моя любимая настройка - авторизация.
Есть отдельный запрос на получение токена. После выполнения токен сохраняется в переменную, а последующие запросы используют его автоматически.
Можно также настроить генерацию UUID, проверки кода ответа и наличия нужных параметров. А запросы выполнять последовательно - в том порядке, который нужен для проверки сценария.
В итоге меньше ручных действий и меньше шансов забыть какую-нибудь мелочь. 💪
Как я организую коллекции?
Сначала делю по проектам, затем по функциональности. Внутри - запросы по отдельным функциям. Через полгода открываешь коллекцию и не играешь в квест «А где же тот самый запрос?».
На одном из проектов мы даже повторили структуру Swagger. Получилось удобно: смотришь описание метода - и понимаешь, где искать соответствующий запрос в Postman.
Коллеги отдельно отмечали, что тесты удобно разделены по группам, а авторизация настроена один раз и используется в последующих запросах. Приятно, когда небольшая настройка экономит время всей команде.
Что раздражает?
Иногда Postman перестает работать из-за блокировок. А после обновлений интерфейс меняется так, что нужную кнопку приходится искать заново. Только привыкнешь - и снова знакомство с приложением. 😅
Но инструмент сам по себе не гарантирует хорошего тестирования. Важно понимать, что именно проверяешь, какие данные отправляешь и какой результат ожидаешь.
А Postman просто помогает делать это удобнее.
А вы для регулярных проверок API что выбираете - Postman, Swagger UI или что-то другое?
· 21.10
Мы в команде в своё время перешли на Hoppscotch и ни разу не пожалели 🙂
По сути, тот же Postman, но легче и с более приятным интерфейсом. Развернули у себя, сделали общие коллекции для QA и разработчиков. Очень удобно делиться прямыми ссылками на конкретные запросы, не нужно ничего экспортировать и пересылать.
Плюс общие переменные окружения, авторизация, скрипты, автоматические проверки и совместная работа без ограничений бесплатного Postman на командные пространства.
В итоге все запросы в одном месте, любой коллега может быстро найти нужный, открыть по ссылке и выполнить. Для повседневной работы с API оказалось очень удобно. Рекомендую попробовать 🙂
1
ответить
коммент скрыт — часть юзеров считает его токсичным или некорректным
коммент удалён
· 21.10
О, спасибо за рекомендацию! 🙂 Раньше не сталкивалась с Hoppscotch, но заинтересовали общие коллекции и возможность делиться ссылками на запросы. Звучит удобно, надо будет попробовать!
0
ответить
коммент скрыт — часть юзеров считает его токсичным или некорректным
ответ удалён