Основы Postman
Last updated
Last updated
Path-параметр позволяет получить определённый ресурс и его характеристики. Добавляется в URL через «:», например – https://petstore.swagger.io/v2/pet/:id. После этого «id» появится в таблице «Path Variables» и для него можно ввести значение. Альтернативный вариант – вписать значение параметра сразу в URL, например – https://petstore.swagger.io/v2/pet/1234, где «1234» – это значение параметра id.
Query-параметр позволяет искать, фильтровать, сортировать данные. Чаще всего используется в GET. Добавляется в URL через «?», несколько параметров отделяются друг от друга с помощью «&». Query-параметр состоит из пары «имя=значение». Появится в таблице «Query Params». Например – https://petstore.swagger.io/v2/pet/findByStatus?status=available.
Параметры и их значения можно вводить в таблицах «Path Variables» и «Query Params», тогда Postman автоматически добавит их в запрос.
Если параметров много, в обеих таблицах есть режим «Bulk Edit». В этом режиме параметры вводятся вручную по следующим правилам:
каждый параметр с новой строки;
имя и значение отделяются «:» без пробелов.
Кнопка Code в правом боковом меню позволяет увидеть, как будет выглядеть запрос (нужно выбрать тип HTTP).
Для передачи данных в форматах XML и JSON необходимо во вкладке body выбрать raw, а затем нужный формат. Формат multipart/form-data позволяет передавать файлы и текст для заполнения форм.
У кнопки Send есть вариант Send and Downloads, который позволяет отправить запрос и одновременно сохранить ответ файлом (формат файла соответствует формату данных ответа).
В блоке ответов Pretty показывает тело запроса с форматированием, а Raw – без форматирования в исходном формате данных. Режим Preview демонстрирует ответ в обработанном виде. Vizualize обрабатывает ответ особым способом (код для визуализации добавляется отдельно).
В блоке ответа помимо Body можно посмотреть Headers, Cookies и Test Results.
Файл Cookie отправляется сервером в ответ на запрос клиента и хранится на стороне клиента. В этом файле содержится информация (идентификация, настройки, предпочтения), которую сервер сможет использовать при ответе на последующие запросы клиента.
Примеры методов для работы с Cookie:
pm.cookies.has(cookieName); - метод проверяет, есть ли cookie с указанным именем (True или False).
pm.cookies.get(cookieName); - метод возвращает значение cookie с указанным именем (если такого cookie нет, тогда вернёт undefined).
pm.cookies.toObject(); - метод возвращает все cookies в виде объекта.
Примеры Headers:
User-Agent - позволяет серверу идентифицировать браузер или другое приложение, которое отправляет запрос на сервер.
Content-Type - указывает тип контента, посылаемого клиентом / возвращаемого сервером, например, текст, HTML, JSON, изображение.
Content-Length - указывает размер содержимого ответа в байтах.
Cache-Control - позволяет определить, должен ли браузер кэшировать ответ и на какой период времени.
Accept - позволяет клиенту указать типы контента, которые он готов принять от сервера.
Authorization - используется для передачи информации об аутентификации, например, токен доступа или логин и пароль.
User-Cache-Control - позволяет клиенту управлять кэшированием ответа на стороне браузера.
Значение любого ключа в path-запросе можно сделать переменной и сохранить для дальнейшего использования в строке и теле запроса (выделить в таблице Path Variables и нажать Set as variable). Переменная имеет вид имя=значение. Мы используем имя переменной, чтобы получить доступ к её значению. Также в переменной можно хранить часть URL.
Переменные хранятся в Environments, здесь же их можно создавать вручную. Переменная может быть двух типов – стандартная и секретная (для паролей, значение скрыто).
У переменных есть области видимости, их можно объединять в коллекции. Запросы также можно объединять в коллекции.
Динамические переменные – для каждого нового запроса создаётся новое значение. Имя такой переменной начинается с «$». Например, динамическая переменная {{$randomInt}} рандомно возвращает любое целочисленное значение в диапазоне от 0 до 100.
В Postman в окне запроса есть вкладка Scripts, где к запросу можно добавлять скрипты, исполняемые перед выполнением запроса (Pre-req) и после выполнения запроса (Post-res). Скрипты пишутся на JS. Их можно добавлять не только к запросам, но также к коллекциям и папкам.
В левой нижней части экрана есть кнопка Console. После отправки запроса в консоли будет выведен запрос и его скрипты.
Сниппеты – «куски кода» (code snippets) для быстрого решения стандартных задач.
