Что такое Postman и как тестировать в нём API

Что такое Postman

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

Кому он полезен:

• Менеджерам — проверить, что обещанная функция API действительно работает и что она возвращает.
• QA-инженерам — тестировать бэкенд отдельно от фронтенда и мобильного приложения.
• Junior-разработчикам — разобраться, как устроено чужое API, прежде чем писать интеграцию.

Postman есть как настольное приложение для Windows, macOS и Linux и как веб-версия. Для большинства функций нужен бесплатный аккаунт.

Из чего состоит запрос

Как отправить GET-запрос

1. Нажмите New → HTTP или «+» рядом со вкладками.
2. Оставьте метод GET.
3. Вставьте адрес, например https://api.example.com/users.
4. Если нужны параметры, добавьте их во вкладке Params — Postman сам допишет их к адресу.
5. Нажмите Send.

Внизу появится ответ сервера.

Как отправить POST-запрос

POST обычно создаёт что-то новое: пользователя, заказ, заявку.

1. Выберите метод POST и укажите адрес.
2. Откройте вкладку Body и выберите формат.
3. Для JSON выберите raw и тип JSON, затем введите данные:

{
  "name": "Aziza",
  "email": "aziza@example.com"
}

4. Нажмите Send.

Какие форматы тела бывают:

• raw → JSON — самый частый вариант для современных API.
• form-data — когда нужно отправить файл или поля формы.
• x-www-form-urlencoded — классические HTML-формы и некоторые старые API.
• binary — один файл целиком.

Какой формат нужен, написано в документации API. Если её нет — спросите разработчика.

Заголовки

Заголовки сообщают серверу дополнительные сведения. Самые частые:

• Content-Type — в каком формате тело запроса. При выборе JSON во вкладке Body Postman подставит его сам.
• Accept — в каком формате вы хотите получить ответ.
• Authorization — данные для входа. Удобнее задавать через отдельную вкладку.

Авторизация

Во вкладке Authorization выберите тип, который указан в документации API:

• Bearer Token — вставляете токен, Postman добавит заголовок Authorization: Bearer <токен>.
• API Key — ключ в заголовке или в параметрах адреса, название поля задаёт API.
• Basic Auth — логин и пароль.
• OAuth 2.0 — Postman может сам пройти процедуру получения токена.

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

Как читать ответ

В блоке ответа смотрите на четыре вещи:

• Код статуса — главный признак успеха или ошибки.
• Время — сколько сервер отвечал.
• Размер ответа.
• Body — сами данные. Режим Pretty форматирует JSON для чтения.

Во вкладке Headers ответа видны служебные заголовки сервера, во вкладке Cookies — куки.

Полезные мелочи

• Импорт cURL: вставьте команду cURL через Import — Postman превратит её в готовый запрос.
• Генерация кода: значок </> справа покажет тот же запрос на JavaScript, Python, PHP и других языках.
• Сохранение: сохраняйте запросы в коллекции, чтобы не собирать их заново.