Postman — главный инструмент QA-инженера. С его помощью можно отправлять запросы к API, чтобы тестировать и документировать работу бэкенда сайта. Рассказываем, как правильно пользоваться Postman и из чего он состоит.
Когда пользователь ищет товар в интернет-магазине, код фронтенда посылает запрос к API сайта. А тот в ответ отправляет найденные в базе данных товары.
API — это набор правил, с помощью которых программы обмениваются данными друг с другом. API создают бэкенд-разработчики.
Как только API написан, программисты проверяют его на работоспособность. Если лицевую часть приложения просто открывают в браузере и имитируют шаги пользователя, то получить доступ к бэкенду нельзя, так как визуального интерфейса у него нет.
Для визуализации интерфейса используют Postman — программу, через которую можно отправлять запросы к API. Если полученные ответы соответствуют ожидаемым — тестируемый сервис работает правильно. Если нет, QA-инженер составляет отчет об ошибке — баг-репорт и отправляет разработчику для исправления проблемы.
Postman — не единственный сервис, позволяющий обращаться к API, но один из самых популярных. Его создал индийский программист Абхинав Астана в 2012 году.
Изначально приложение работало как расширение для Chrome. Затем появилась полноценная кроссплатформенная программа и узнаваемый логотип — летящий космонавт.
Ключевые преимущества Postman:
А теперь разберем функционал Postman подробнее. Сейчас у Postman есть расширение для Chrome и версия для декстопа под все популярные операционные системы. Мы будем использовать второй вариант.
Скачайте программу и зарегистрируйтесь в ней. Первым делом нужно создать рабочее пространство: в нем мы будем писать запросы и хранить историю.
В Postman есть четыре вида пространств:
Создав персональное пространство, вы увидите рабочую область.
А теперь пройдемся по основным инструментам Postman, которые находятся на вертикальной панели.
Чтобы сделать первый запрос, в открытой рабочей области нажмите на плюсик.
Откроется поле, в котором можно писать запросы.
Там можно заполнить:
GET, его используют для получения данных с сервера.Попробуем использовать GET — метод для получения ресурса по id. Введем в строку адрес тестового API — https://jsonplaceholder.typicode.com/posts. И далее нажимаем кнопку Send.
У нас появился статус 200 ОК — это значит, что запрос успешно выполнен. А в нижнем поле мы получили подробности об ответе.
Мы разобрали, как работает конструктор запросов. С его помощью можно проверять как собственное API, так и сторонних сервисов. Мы будем использовать тот же публичный тестовый API.
Для создания любого запроса нужен как минимум адрес и метод. Список методов:
GET. Используют для получения информации. Через него делают запросы к конкретным ресурсам. А дополнительные данные в нем могут передаваться прямо в адресной строке запроса.POST. Применяют для внесения новой информации на сервер. Через него можно посылать как данные в стандартном двоичном коде, так и разные типы файлов. Этот метод применяют во время регистрации или авторизации пользователя.PUT. Метод отвечает за добавление новой информации или внесение изменений на сервер.DELETE. Используют, чтобы удалить данные. Необходимо применять его правильно, в противном случае есть вероятность ошибок из-за удаления критически важных файлов.Воспользуемся методом POST и создадим нового пользователя. Эта задача уже сложнее: нам потребуется отправить на сервер любые данные.
Переходим во вкладку body и JSON, а затем копируем информацию о любом пользователе из предыдущего задания. Получаем ответ — 201 Created. У нас все получилось.
А теперь поговорим о статусах. Это первый, хотя и не единственный результат проверки. Статус — это трехзначный код, первая цифра показывает, к какой группе он принадлежит.
Тесты — это скрипты, которые помогают удостовериться, что API работает корректно. В Postman можно создать такие автоматические тесты за несколько шагов на основе готовых сниппетов (заранее написанных скриптов). Для этого вернемся к предыдущему запросу и перейдем во вкладку «Test».
В боковой панели справа найдем список под «Snippets», нажмем на «Status code: Code is 200».
У нас появится код, с его помощью можно проверять запрос на исполнение.
Нажмите отправить и получите в ответ результаты теста.
Начнем с создания коллекции для сохранения готовых решений. Откройте на боковой панели слева соответствующую вкладку. Нажмите на плюсик и создайте новую коллекцию.
Там будет четыре вкладки, на которые нам нужно обратить внимание:
Чтобы запустить коллекцию тестов, зайдите во вкладку «Коллекции», выберите необходимую коллекцию и в выпадающем списке выберите «Run Collection».
Справа будут варианты настройки. Нужно выбрать количество итераций (Iteration) и задержку (delay).
Запускать скрипты без задержки не рекомендуют, так как это может привести к ошибочным результатам.
Затем нажмите кнопку «Run New Collection» и получите отчет о выполнении.
Потренировавшись самостоятельно писать запросы, можно подробнее разобрать, как работают эти запросы.
В нижней части приложения мы видим поле «Response», в которое приходит ответ. У него есть три вкладки:
Когда мы посылали запрос методом POST, нам нужно было указать данные. Для этого использовали вкладку «Body». Она принимает разные типы данных, выбор решения будет зависеть от API.
По умолчанию в Postman стоит значение «raw» — это значит, что приложение само определяет заголовок в зависимости от того, что пишет пользователь. Но можно выбирать и другие варианты.
Postman — один из самых распространенных сервисов для тестирования API и создания запросов. Большинство QA-инженеров регулярно им пользуются. Это такой же обязательный инструмент профессии, как и среда разработки для программистов.
Начать работать с Postman несложно, это приложение максимально дружелюбно к новичку. Его основное достоинство — простой графический инструмент.
У приложения есть бесплатная версия, которая незначительно отличается от платной. Основная сущность в Postman — запрос, позволяющий получить, отправить или удалить данные из API.