Postman

Postman — это инструмент, который отправляет HTTP-запросы к API и отображает ответы сервера. Он используется для проверки корректности работы интерфейсов приложения и анализа поведения серверной части при передаче данных. Программа обеспечивает единый интерфейс для формирования запросов, настройки окружений, группировки сценариев тестирования и автоматизации последовательных операций. Postman работает на Windows, Linux и macOS, а также имеет web-версию, использующую Desktop Agent для отправки запросов.

Назначение Postman

Инструмент применяется при создании, проверке и документировании API. Он используется разработчиками, тестировщиками, аналитиками и инженерами, которые взаимодействуют с HTTP-протоколом. Клиент формирует запрос, передает его серверу и выводит возвращенные данные в структурированном виде. Это позволяет выявлять ошибки в обработке параметров, логике обработчиков, авторизации, форматировании ответа и корректности работы маршрутов.

Postman поддерживает любые стандартные HTTP-методы, заголовки, телo запросов различных типов и механизмы аутентификации. Программа упрощает работу с API, где задействованы разные параметры, версии маршрутов и конфигурации стендов. Все настройки запроса сохраняются в коллекции, что уменьшает повторяемые действия и ускоряет проверку API.

Работа с запросами

Каждый запрос формируется во вкладке, где задаются метод, URL, параметры, тело, заголовки и переменные окружения. Интерфейс показывает все части запроса, позволяя менять их без изменения остальных элементов.

Основные элементы:

• метод HTTP — выбор операции взаимодействия с данными;

• URL — путь к ресурсу или методу API;

• Params — набор параметров строки запроса;

• Headers — ключевые заголовки, включая авторизацию;

• Body — данные, передаваемые на сервер;

• Tests — JavaScript-скрипты для проверок результата;

• Response — код состояния, тело и служебные показатели ответа.

Пример простого GET-запроса на проверочный стенд Postman:

GET https://postman-echo.com/get?userId=333

Во вкладке Params автоматически будет создан параметр userId со значением 333. После отправки клиент выдаст ответ от echo-сервера, предназначенного для демонстрации поведения запросов.

Пример фрагмента возвращаемого JSON:

{
  "args": {
    "userId": "333"
  }
}

Коллекции и структура проекта

Коллекция — файл проекта Postman, содержащий набор связанных запросов. Она используется для решения задач, относящихся к одному API, версии приложения или функциональному модулю. Запросы внутри коллекции можно объединять в папки, отражающие структуру тестируемой системы: операции авторизации, работа с ресурсами, взаимодействие между подсистемами и т.д.

Особенности коллекций:

• сохраняют параметры, переменные, логику запуска и шаблоны запросов;

• позволяют переиспользовать запросы на разных стендах;

• обеспечивают последовательный и контролируемый прогон сценариев;

• поддерживают интеграцию скриптов до и после выполнения запросов.

Коллекции применяются как для ручного тестирования, так и для автоматизированных прогонов. Каждый запрос можно выполнить из интерфейса, изменить на лету и сохранить изменения.

Окружения

Postman использует окружения для переключения между различными наборами переменных, применяемых к запросам. Это необходимо при работе с несколькими контурами — локальным, тестовым, стейджинговым или боевым. Переменные подставляются в URL, токены, параметры или тело запроса.

Пример определения переменной окружения:

{{base_url}}/api/v1/users

Подстановка значения обеспечивает универсальность запросов при минимальной корректировке параметров.

Автоматизация через Collection Runner

Collection Runner запускает последовательность запросов в указанном порядке с заданным числом итераций. Он выполняет их без ручного участия, используя переменные окружения, тесты и обработчики данных. После завершения Run Tool формирует отчет с отметками об успешности каждого запроса, кодами ответа и статистикой выполнения.

Collection Runner используется:

• для проверок стабильности API при многократных прогонах;

• для последовательных сценариев — регистрация пользователя, получение токена, выполнение операций;

• для регрессионных тестов;

• для проверки поведения API при работе с изменяющимися данными.

Пример тестового скрипта для проверки статуса ответа:

pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

Скрипты выполняются после получения ответа сервера и фиксируют результат. Они позволяют использовать вывод одного запроса как входные данные для другого, что делает коллекцию полноценным инструментом автоматизированного тестирования API.

REST-методы в Postman

Для работы с API применяется стандартный набор HTTP-методов архитектуры RESTful. Каждый метод определяет тип операции над объектом или ресурсом.

Основные методы:

• POST — создание ресурса или отправка данных для обработки;

• GET — получение данных от API;

• PUT — обновление объекта;

• DELETE — удаление ресурса.

Postman позволяет изменять метод в любом запросе, сохраняя остальные параметры вкладки. Ответ сервера отображается вместе с кодом статуса, временем обработки и размером полученных данных.

Коды состояния HTTP

Postman выводит статусный код, который описывает результат обработки запроса сервером. Коды разделяются на категории:

• 1xx — информационные ответы;

• 2xx — успешная обработка;

• 3xx — перенаправление на другой ресурс;

• 4xx — ошибки клиента: неверные параметры, отсутствующие данные, недействительные маршруты;

• 5xx — ошибки сервера: некорректная логика или сбой при обработке запроса.

Пример успешного ответа:

HTTP/1.1 200 OK

Статус 200 подтверждает, что API корректно обработал запрос.

Пример ручного тестирования идентификатора пользователя

Проверка получения идентификатора пользователя через учебный API:

1. Создать коллекцию, например UseridTest.

2. Добавить новый запрос.

3. Указать URL:

   https://postman-echo.com/get?userId=333

4. Выбрать метод GET.

5. Нажать Send.

6. Просмотреть тело ответа во вкладке Response.

Postman автоматически сформирует структуру ответа и выведет код состояния. При корректной работе echo-сервера код будет равен 200, а тело ответа отразит переданное значение userId.

Postman - это приложение для тестирования и отправки HTTP-запросов. Оно позволяет создавать и сохранять запросы, а также просматривать и анализировать ответы от серверов. Postman может использоваться для разработки и отладки API, а также для тестирования веб-приложений.