Postman – популярная программа для тестирования API, в том числе и путем отправки запросов GET и POST на имеющийся сервер. Она обладает графическим интерфейсом, которым удобно пользоваться. При помощи postman разработчик/тестировщик получит возможность настраивать передаваемые куки, HTTP-заголовки, а также разнообразные параметры форм.
Далее postman будет рассмотрен более подробно. Предстоит научиться формировать запросы, передавать параметры и документы. Также предстоит изучить Basic Auth и коллекции запросов.
Инициализация
Задумываясь, как пользоваться postman, необходимо запомнить, что данный процесс начинается с инициализации. Загрузку программного обеспечения можно произвести через официальный сайт postman. Он поддерживает несколько версий:
- Windows;
- MacOS;
- Linux.
Полученный «Мастер Установки» потребуется запустить на устройстве. В Linux присутствует возможность инициализации приложения для работы с запросами и тестированием из центра программ Ubuntu. Также в этом поможет универсальный менеджер пакетов snap:
При первом запуске ПО предлагает создать бесплатный аккаунт. Он потребуется для того, чтобы синхронизировать результаты проделанной работы между несколькими устройствами. Для входа в уже имеющийся профиль потребуется нажать на кнопку «Sign In». Создание нового аккаунта начинается после клика по «Create…».
Интерфейс
Перед использованием Postman и формирования запросов необходимо изучить главное окно:
Оно разделяется на несколько частей:
- верхняя панель – место, в котором располагаются основные компоненты настроек программы;
- боковая панель – тут отображается список запросов, которые были выполнены ранее, а также сохраненные в виде коллекций;
- панель вкладок – дает возможность переключаться между вкладками запросов;
- рабочая область – место, в котором находятся все настройки запроса и возвращенные к ним сведения.
Использование сложных postman-запросов изучать на первых порах не рекомендуется. Далее предстоит пользоваться элементарными «командами».
Основы работы
Далее предстоит разобраться, как отправить запрос и обработать его тем или иным способом. Предложенные ниже рекомендации и инструкции являются базовыми. Без них более глубокое изучение Постмана невозможно.
Выполнение
Выполнить простой request без сохранения в collection можно выполнить следующие действия:
- Найти на панели вкладок кнопку со знаком плюса. Нажать на по ней.
- В появившейся вкладке сформировать тело запроса. Пример – GET или POST. Здесь же можно указать URL, которую хочется открыть.
- Нажать на кнопку Send по завершении формирования requests.
Выше – пример получения главной страницы lost.pro. В нижней части экрана появится HTML-код. Он включает в себя несколько вкладок:
- Body – тело. Все, что было возвращено сервером.
- Cookie – куки. Они записаны сервером при обработке информации.
- Headers – возвращенные заголовки.
В разделе Body поддерживается настройка особенностей отображения сведений на дисплее. Pretty отвечает за форматирование, удобное для чтения. Raw – это вывод информации «как есть». Preview позволяет увидеть открытый веб-сайт.
Передача параметров
Postman предоставляет собственный API-сервис, используемый для тестирования API-клиентов. Он называется postman-echo-com. Пример – при отправке запроса по postman-echo.com/git и передачи туда нескольких параметров, в ответ придут эти же сведения, но уже вместе с заголовками формата JSON.
Для передачи параметров необходимо:
- Выбрать тип запроса GET.
- В поле URL указать postman-echo.com/get.
- Перейти в раздел Params.
- Указать в Query Params имя параметра. Пример – foo. Напротив него – значение (bar). Их может быть несколько.
- Нажать на кнопку Send.
Рекомендуется снять галочки-отметки с параметров, чтобы они не мешали при последующих queries.
Параметры формы
Если нужно через postman отправить запрос Post, действовать по ранее предложенному алгоритму не получится. Связано это с тем, что параметры будут передаваться не в URL, а непосредственно в теле «команды».
Потребуется в postman выбрать тип POST и указать соответствующий URL, опираясь на ранее предложенный пример. Далее – перейти во вкладку Body и поставить отметку около form-data. Остается добавить по уже известному принципу необходимые параметры, а затем кликнуть по кнопке отправки query.
Заголовки
В postman можно передавать токены авторизации при помощи HTTP-заголовков. Подобные операции выполняет движок PHP-Xenforo. Для передачи в заголовках информации на сервер потребуется перейти в раздел Headers. Далее – добавить имя заголовка и его характеристики. URL и метод будут такими же. Пример – X-Header-Foo со значением bar.
После отправки query в postman он появится в разделе Headers в самом низу окна. Это укажет на то, что произошла его передача непосредственно на сервер.
Файлы
Postman поддерживает работу не только с текстом, но и с другими видами информации. Для передачи документа потребуется:
- Запустить postman.
- Перейти в раздел Body-form-data.
- Деактивировать нужный параметр.
- Выставить вместо характеристики Text-File.
Теперь необходимо кликнуть по Select file, выбрать документ и подтвердить операцию. Полученный файл будет находиться в секции files после успешной отправки на сервер.
Авторизация
Basic Auth – средство защиты URL на сервере. Оно поддерживается Postman. В качестве примера рекомендуется использовать API URL postman-echo.com/basic-auth. Именем пользователя послужит «postman», а паролем – «password».
В рабочей области изучаемого приложения потребуется открыть вкладку Authorization. Теперь в разделе Type необходимо выбрать пункт Basic Auth. Остается лишь ввести авторизационные данные и подтвердить вход в систему.
При успешной обработке запроса тестовый сервер отправит в ответ authenticated: true.
История запросов
Ранее выполненные запросы с легкостью просматриваются пользователями. Соответствующий инструмент postman упрощает процедуру работы с приложением. Он дает возможность выбора одних и тех же данных, если необходимо выполнить ранее обработанный query.
Для просмотра истории запросов потребуется перейти в боковую панель. Там – открыть вкладку History. В ней появятся все «команды». Они отсортированы по дате отправки. Можно открыть любой из предложенных вариантов для просмотра того, что вернул сервер.
Коллекции
Иногда при тестировании и формировании запросов необходимо выполнять одни и те же операции с определенными параметрами. В postman есть инструмент, который облегчит соответствующую задачу. Он называется «Коллекции». Встроен в приложение по умолчанию.
Чтобы создать коллекцию, потребуется:
- Нажать на верхней панели по кнопке New.
- В появившемся списке кликнуть по Collection.
- Ввести имя коллекции. Сохранить данные.
- Нажать снова на New в postman.
- Выбрать Request.
- Указать имя запроса и выбрать коллекцию, в которой его следует отнести.
- Щелкнуть по кнопке Create.
- Заполнить данные.
Когда все готово, остается нажать на кнопку Save. Она появится около Send. Найти соответствующий запрос удастся через боковую панель приложения. Для этого пользователю предстоит переключиться во вкладку Collections и выбрать подходящий вариант.
За счет авторизации все postman get и другие query будут синхронизированы между собой. Они автоматически загружаются на устройствах, где используется приложение. Без авторизации пришлось бы каждый раз все операции прописывать вручную с нуля.
Сегодня postman широко используется не только программистами, но и QA-инженерами для тестирования. Для его освоения рекомендуется пройти специализированные дистанционные компьютерные онлайн курсы по направлению «Тестирование ПО».
P. S. Хотите знать больше? Обратите внимание на курсы по тестированию в Otus. Присутствуют варианты как для продвинутых, так и для начинающих пользователей.