Как пользоваться Postman: первый запрос, коллекция и переменные

На всё уйдёт около получаса. Инструкция написана для Windows 11, на macOS и Linux окно программы такое же. Для примера понадобится адрес API, с которым вы работаете, и, если он закрыт, ключ или токен доступа — их выдаёт разработчик сервиса или ваш коллега.

Скачайте и установите Postman

Откройте раздел загрузки на официальном сайте postman.com и скачайте версию для Windows. Установщик не задаёт вопросов: он сам ставит программу в папку пользователя, поэтому права администратора не нужны, и сразу её запускает.

Через менеджер пакетов Windows программу можно поставить одной командой:

winget install Postman.Postman

Войдите в аккаунт

При первом запуске Postman предложит войти или создать аккаунт. Регистрация бесплатная, можно по почте. Без входа откроется облегчённый режим: в нём можно отправлять запросы, но не сохранять коллекции и окружения, поэтому для постоянной работы аккаунт всё же понадобится.

После входа создайте рабочее пространство. Для личных задач выберите пустое пространство для себя; если работаете в команде, коллеги смогут присоединиться к общему по приглашению.

Отправьте первый запрос

Нажмите кнопку создания нового элемента и выберите HTTP-запрос. Откроется вкладка с тремя главными частями: слева от строки адреса — метод (GET, POST, PUT, DELETE и другие), в строке — адрес, ниже — вкладки для параметров, авторизации, заголовков и тела запроса.

• Оставьте метод GET и вставьте адрес нужного метода API.
• Если API требует ключ, откройте вкладку авторизации и выберите подходящую схему, например Bearer Token, и вставьте токен.
• Нажмите кнопку отправки. Внизу появятся код ответа, время, размер и тело ответа — JSON показывается с подсветкой и отступами.

Если у вас есть готовая команда cURL из документации сервиса, её не нужно разбирать вручную: вставьте её целиком в строку адреса, и Postman сам заполнит метод, заголовки и тело.

Сохраните запрос в коллекцию

Нажмите кнопку сохранения и создайте новую коллекцию, например по названию сервиса. Внутри коллекции заводите папки по разделам API: пользователи, заказы, платежи. Так запросы не потеряются среди вкладок, а коллега сможет открыть всю коллекцию сразу.

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

Вынесите адрес и токен в переменные

Создайте окружение, например «Тест», и добавьте в него две переменные: baseUrl с адресом сервера и token с токеном доступа. Для токена выберите тип «секрет», чтобы значение было скрыто на экране. Затем выберите это окружение в списке в правом верхнем углу.

Теперь в строке адреса замените начало адреса на переменную в двойных фигурных скобках, а в авторизации подставьте вторую:

{{baseUrl}}/users
Bearer Token: {{token}}

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

Добавьте проверку ответа

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

pm.test("Сервер ответил 200", function () {
  pm.response.to.have.status(200);
});

Отправьте запрос ещё раз: на вкладке результатов тестов появится зелёная отметка. Готовые заготовки проверок есть в боковой панели редактора скриптов, а ИИ-помощник может предложить проверки по ответу сервера.

Запустите всю коллекцию

Откройте меню коллекции и выберите запуск. Postman по очереди выполнит все запросы с выбранным окружением и покажет, какие проверки прошли, а какие нет. Теперь после каждого обновления API достаточно запустить коллекцию, чтобы за минуту убедиться, что ничего не сломалось.

Если что-то пошло не так