Wiki · Технологии разработки

Postman

4 мин чтенияАвтор: Сергей ЧерняковСоавторы: Евгений Баев

Содержание 5 разделов

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

В переписке с разработчиком Postman обычно всплывает так: «Интеграция с CRM готова, коллекцию Postman прислали». Коллекция – это набор готовых запросов: создать заявку, получить статус заказа, выгрузить остатки. Открыв её, вы сами отправите запрос и увидите, что отвечает сервер, без единой строки кода.

Из чего состоит рабочее пространство Postman

Запрос: адрес, метод (GET, POST и другие), заголовки, тело. Ответ показывается рядом с кодом статуса и временем.
Коллекция: папка с запросами, которую можно экспортировать файлом или отдать коллегам через общее пространство.
Окружение: набор переменных. Адрес тестового и боевого сервера, токены доступа. Переключили окружение, и те же запросы идут на другой сервер.
Скрипты: проверки на JavaScript, которые выполняются после ответа. Например, что статус 200, а в ответе есть номер заказа.
Мок-сервер и документация: заглушка, которая отвечает как будущий API, и страница с описанием запросов.

Кроме обычных HTTP-запросов Postman умеет GraphQL, gRPC, WebSocket, SOAP и вебхуки. Если спецификация API уже описана в формате OpenAPI, её импортируют, и коллекция собирается из неё.

Схема коллекции Postman для интеграции сайта с CRM: папки с запросами по заявкам и каталогу и два окружения, тестовое и боевое — Что лежит в коллекции Postman

Как проверить интеграцию по коллекции от подрядчика

Допустим, сайт должен передавать заявки в CRM. Подрядчик говорит, что всё работает. Условный пример проверки:

Импортируйте коллекцию и окружение, которые прислал подрядчик. Попросите тестовое окружение, а не боевые ключи.
Отправьте запрос «создать заявку» с тестовыми данными. Посмотрите код ответа: 200 или 201 означает, что сервер принял запрос. Расшифровка кодов есть в статье Коды ответов сервера.
Откройте CRM и найдите заявку. Ответ сервера ещё не значит, что данные легли в нужные поля.
Отправьте заведомо плохой запрос, например без телефона. Нормальный API вернёт понятную ошибку, а не пустой ответ с кодом 200.
Запустите всю коллекцию через Collection Runner: если в ней есть проверки, вы увидите, какие прошли.

Для сайта на 1С-Битрикс так же проверяют обмен с CRM: подробно про связку сайта и CRM рассказываем в статье Интеграция сайта с CRM.

Попросите, чтобы коллекция осталась у вас вместе с кодом. Новая команда по ней за полчаса поймёт, как устроена интеграция.

Postman в автоматических проверках

Кнопка в окне программы не единственный способ запуска коллекции. Для автоматического запуска есть Postman CLI и более старая консольная утилита Newman: их ставят на сервер сборки, и после каждого обновления кода коллекция прогоняется сама. Если API перестал отдавать нужное поле, сборка покажет ошибку до того, как сломается сайт. Это не заменяет полноценные автотесты, но для интеграций часто достаточно.

Пять шагов проверки интеграции по коллекции Postman: импорт, тестовый запрос, код ответа, проверка в CRM, запрос с ошибкой — Как проверить интеграцию по коллекции

Доступ из России и чем заменить Postman

Для общих рабочих пространств Postman нужна учётная запись, а данные коллекций хранятся в облаке компании. Официального списка стран, где сервис недоступен, мы не нашли; в условиях использования есть пункт об экспортных ограничениях США. Поэтому на октябрь 2026 года условия доступа для России уточняйте у вендора и держите коллекции экспортированными в репозитории проекта.

Альтернативы с похожей логикой: Insomnia, Bruno (хранит коллекции файлами рядом с кодом), Hoppscotch, HTTP-клиент в средах разработки JetBrains. Формат запросов у всех понятный, перенос коллекции обычно занимает немного времени.

Коллекции Postman, проверка API и замена программы

Как открыть коллекцию Postman, которую прислал разработчик?

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

Чем Postman отличается от Swagger?

Postman нужен, чтобы отправлять запросы и проверять ответы, а Swagger (точнее, спецификация OpenAPI и Swagger UI) описывает, какие запросы у API вообще есть. Они дополняют друг друга: спецификацию импортируют в Postman, и из неё собирается коллекция для проверки.

Почему запрос в Postman проходит, а с сайта нет?

Частая причина в браузере: Postman не подчиняется правилам CORS, а страница сайта подчиняется, и сервер может не разрешать запросы с вашего домена. Ещё сравните заголовки, токен и окружение: в Postman вы могли стучаться на тестовый сервер, а сайт ходит на боевой. Наконец, посмотрите вкладку «Сеть» в инструментах разработчика браузера: там видно, какой запрос ушёл на самом деле и что вернул сервер, и это быстро сужает круг поиска.

Где хранить коллекции Postman, чтобы не потерять их при смене подрядчика?

Экспортируйте коллекции и окружения файлами и храните в репозитории проекта рядом с кодом, без боевых паролей и токенов. Облачное пространство Postman удобно для команды, но доступ к нему остаётся у того, кто его создал.

Если у вас уже работает сайт с интеграциями, проверяем и доделываем обмен с CRM, 1С и внешними сервисами при доработке существующего сайта, а коллекции запросов передаём вместе с кодом.

Источники

Документация Postman (Postman Docs): коллекции, окружения, скрипты, Postman CLI и Newman
Postman: условия использования, раздел об экспортных ограничениях