Postman – популярная программа для тестирования API, в том числе и путем отправки запросов GET и POST на имеющийся сервер. Она обладает графическим интерфейсом, которым удобно пользоваться. При помощи postman разработчик/тестировщик получит возможность настраивать передаваемые куки, HTTP-заголовки, а также разнообразные параметры форм.
Далее postman будет рассмотрен более подробно. Предстоит научиться формировать запросы, передавать параметры и документы. Также предстоит изучить Basic Auth и коллекции запросов.
Инициализация
Задумываясь, как пользоваться postman, необходимо запомнить, что данный процесс начинается с инициализации. Загрузку программного обеспечения можно произвести через официальный сайт postman. Он поддерживает несколько версий:
Полученный «Мастер Установки» потребуется запустить на устройстве. В Linux присутствует возможность инициализации приложения для работы с запросами и тестированием из центра программ Ubuntu. Также в этом поможет универсальный менеджер пакетов snap:
Postman — основы в 5 минут. Postman для начинающих
При первом запуске ПО предлагает создать бесплатный аккаунт. Он потребуется для того, чтобы синхронизировать результаты проделанной работы между несколькими устройствами. Для входа в уже имеющийся профиль потребуется нажать на кнопку «Sign In». Создание нового аккаунта начинается после клика по «Create…».
Интерфейс
Перед использованием Postman и формирования запросов необходимо изучить главное окно:
Оно разделяется на несколько частей:
- верхняя панель – место, в котором располагаются основные компоненты настроек программы;
- боковая панель – тут отображается список запросов, которые были выполнены ранее, а также сохраненные в виде коллекций;
- панель вкладок – дает возможность переключаться между вкладками запросов;
- рабочая область – место, в котором находятся все настройки запроса и возвращенные к ним сведения.
Использование сложных postman-запросов изучать на первых порах не рекомендуется. Далее предстоит пользоваться элементарными «командами».
Основы работы
Далее предстоит разобраться, как отправить запрос и обработать его тем или иным способом. Предложенные ниже рекомендации и инструкции являются базовыми. Без них более глубокое изучение Постмана невозможно.
Выполнение
Выполнить простой request без сохранения в collection можно выполнить следующие действия:
Postman для REST API запросов. Быстрый старт и переменные
- Найти на панели вкладок кнопку со знаком плюса. Нажать на по ней.
- В появившейся вкладке сформировать тело запроса. Пример – 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. Присутствуют варианты как для продвинутых, так и для начинающих пользователей.
Источник: otus.ru
Программа postman как пользоваться
В примерах рассмотрим статус 200 ОК, который информирует об успешности выполнения операции, т.е. пользователь когда получает ожидаемый результат – страницу с запрашиваемой информацией.
Примеры запросов в Postman для быстрого обучения тестировщика
После запуска в Postman стоит создать папку с коллекцией запросов. Для этого нужно во вкладке Collections нажать на New Collection.
Указываем название коллекции.
Создаем запрос нажатием на Add requests.
POST
Рассмотрим регистрацию пользователя, поэтому указываем соответствующее название и нажимаем на Save to [Collections name].
Выбираем POST.
Указываем url тестируемого сайта.
Прописываем название соответствующего API, в данном случае api/register.
Во вкладке Body выбираем raw.
Далее выбираем формат текста JSON.
Нажатием на Send отправляем данные.
В соответствующем поле видим ожидаемый результат, указанный в документации и статус 200 ОК.
GET
Выполним запрос на получение данных о созданном пользователе, выбираем GET.
Указываем ссылку на API и после отправления смотрим на полученный результат, соответствующий ожидаемому.
PUT
Попробуем обновить данные пользователя, для этого создаём update_user.
Указываем ссылку с url и API, открываем окно для кода.
Отправляем новые данные.
В результате указана обновленная информация и время, когда были внесены изменения. Дополнительно успешность операции подтверждает ответ 200 от сервера.
DELETE
Создаём запрос на удаление пользователя.
Указываем полную ссылку на страницу пользователя и отправляем.
Получаем от сервера в ответ статус 204 No Content, информирующий об успешности запроса, но без содержимого, т. е. данные были успешно удалены.
Документация, необходимая тестировщику для обучения
Ознакомиться со всеми функциями инструмента можно в документации от разработчиков Postman. В информационном центре представлена инструкция по составлению ручных и автоматизированных запросов, настройке коллекций, использованию cookies, сбору данных, а также по составлению запросов для устранения ошибок и прочее.
Хочу научиться программировать с нуля, но не знаю, с чего начать. Что делать?
Можно учиться самостоятельно (долго) или пойти на курсы с преподавателями (быстро). Плюс нужно учитывать, что джунов много, конкуренция выше и работодатели повышают порог вхождения при найме на работу. Чтобы получить актуальные знания, мы в proglib.academy запустили курсы:
- Основы программирования на Python.
- Профессия Python-разработчик.
- Алгоритмы и структуры данных.
- Математика для Data Science.
- Профессия Data Science.
- Frontend Basic: принцип работы современного веба.
- Профессия Фронтенд-разработчик.
- Обработка естественного языка. Полный курс.
На подходе еще больше 10 курсов для взрослых и детей.
Источники
- https://habr.com/ru/post/464261/#api
- https://youtu.be/55l6XIEK9l0
- https://learning.postman.com/docs/publishing-your-api/documenting-your-api/
- https://youtu.be/hGmJMeE_ok0
- https://youtu.be/-ToBThG8ems
- https://learning.postman.com/docs/sending-requests/requests/
- https://youtu.be/00h6cabFnLE
Источник: proglib.io
Большой гайд по работе с Postman API Platform
Postman API Platform — это популярный HTTP-клиент для создания, тестирования и документирования API. Он позволяет отправлять запросы различным сервисам и работать с их ответами. Настоящая палочка-выручалочка для тестирования бэкенда.
Главные преимущества Postman
Давайте сразу договоримся: в комментариях вы можете предлагать любой аналогичный сервис и расписывать его плюсы. Но поскольку статья у нас о Постмане, то и дифирамбы будем петь ему.
Для начала держите ссылку на Postman, чтобы иметь возможность изучать его параллельно со статьёй. Дальше перекатываемся к преимуществам сервиса:
- Бесплатный.
- Он интуитивно-понятен, а потому предельно прост в использовании и подходит даже новичкам.
- Поддерживает REST, SOAP, GraphQL.
- Расширяемый с помощью Postman API.
- Интегрируемый в CI/CD с помощью консольной утилиты Newman.
- Большое комьюнити, что позволяет получить ответ практически на любой вопрос.
Загрузка и установка Postman
Поскольку теперь вы знаете о приложении и ознакомились с принципами его работы, пришло время установить приложение. В этой статье мы рассмотрим, как загрузить и установить Postman на ОС Windows.
Стоит отметить, что Postman доступен для Windows, Linux и MacOS в виде отдельного приложения. Вы можете установить приложение двумя способами:
- Как отдельное десктопное приложение
- Как расширение Google Chrome