Задать вопрос
Все статьи / Полезная информация / Мониторинг API с помощью Postman
Найти результаты:
Период:
с:
 
по:
Помощь в поиске

Помощь в поиске

apple banana
Найти записи, которые содержат хотя бы одно из двух слов.

+apple +juice
Найти записи, которые содержат оба слова.

+apple macintosh
Найти записи, которые содержат слово 'apple', но положение записей выше, если они также содержат 'macintosh'.

+apple -macintosh
Найти записи, которые содержат слово 'apple', но не 'macintosh'.

+apple ~macintosh
Найти записи, которые содержат слово 'apple', но если запись также содержит слово 'macintosh', rate it lower than if row does not. Это более "мягкий" чем поиск '+apple -macintosh', для которого наличие 'macintosh' вызывает что записи не будут возвращены вовсе.

+apple +(>turnover <strudel)
Найти записи, которые содержат слова 'apple' и 'turnover', или 'apple' и 'strudel' (в любом порядке), но ранг 'apple turnover' выше чем 'apple strudel'.

apple*
Найти записи, которые содержат такие слова как 'apple', 'apples', 'applesauce', или 'applet'.

"some words"
Найти записи, которые содержат точную фразу 'some words' (например записи содержащие 'some words of wisdom', но не "some noise words").

Мониторинг API с помощью Postman

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

В отличие от тестирования на этапе разработки, мониторинг применяется в рабочей среде и показывает реальную картину: есть ли ошибки, как часто они возникают, не упала ли скорость отклика, а также нет ли проблем с безопасностью.

API стали основой цифровых сервисов. Через них проходят множество операций, бизнес-процессов и интеграций. Поэтому контроль их работы — необходимое условие для устойчивой работы любой системы.

Зачем нужен мониторинг API

Мониторинг API решает сразу несколько задач:

  • Поддержка стабильности. Ошибки или задержки в работе API могут повлиять на процессы. Мониторинг помогает вовремя их выявлять и сокращать время устранения.
  • Контроль качества услуг. Если компания предоставляет API клиентам, нужно выполнять условия по доступности и скорости. Мониторинг помогает отслеживать выполнение этих обязательств.
  • Раннее выявление проблем. Система показывает, когда падает производительность или появляются ошибки, еще до того, как это заметят пользователи.
  • Отслеживание сторонних сервисов. Если работа зависит от внешних API, мониторинг позволяет понять, что источник сбоя находится за пределами собственной системы.
  • Обеспечение безопасности. Непрерывная проверка API помогает вовремя находить уязвимости и защищать данные.
  • Контроль сложных сценариев. Когда запросы проходят через несколько API подряд, мониторинг фиксирует результат на каждом этапе и дает уверенность в правильной работе цепочки.

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

Postman как инструмент для тестирования и мониторинга API

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

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

  • Коллекции. В Postman можно объединять запросы в коллекции и запускать их как вручную, так и по расписанию. Это позволяет проверять не только отдельные запросы, но и целые рабочие сценарии. Дополнительно можно настраивать повторные попытки выполнения запросов.
  • Интеграции с другими системами. Postman можно связать с сервисами вроде Datadog или New Relic. Это удобно: метрики по работе API сразу попадают в привычные системы мониторинга. 
  • Уведомления об ошибках. Если запрос завершился неудачно, Postman отправит уведомление на почту. А значит, вы сможете быстро реагировать на проблемы.
  • Наглядная визуализация. Все результаты мониторинга отображаются на встроенной панели. На ней удобно смотреть историю запусков, фильтровать данные по регионам, типам запросов и результатам выполнения.
  • Автоматическая проверка безопасности. В Postman встроены инструменты для поиска уязвимостей в API. Проверки можно настраивать и запускать автоматически, включая их в процесс CI/CD.

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

Преимущества использования Postman для мониторинга API

Главное преимущество Postman в том, что он объединяет тестирование и мониторинг в одном инструменте. С его помощью можно не только разово проверить работу API, но и организовать постоянное наблюдение за его состоянием. С ним вы можете заранее выявлять ошибки и сбои, видеть, как меняется производительность в режиме реального времени, и быстро реагировать на проблемы.

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

Отдельного внимания заслуживает безопасность — Postman позволяет запускать автоматические проверки на уязвимости и добавлять их прямо в конвейер CI/CD. 

Создание аккаунта в Postman

Перед установкой Postman стоит создать аккаунт. Для этого нужно перейти на страницу регистрации, ввести рабочую почту, имя пользователя и пароль, а затем нажать Create Free Account

Также доступен вход через Google, GitHub или SSO.

После регистрации в Postman появится окно приветствия. В нем нужно выбрать роль, которая ближе всего описывает вашу занятость: например, разработчик, тестировщик или студент.

Postman предложит выбрать тариф: Basic, Professional и Enterprise с расширенными возможностями. 

Но для начала работы можно нажать Continue with Free Plan в правом верхнем углу и остаться на бесплатной версии. Она дает все базовые функции для тестирования и мониторинга API, поэтому подходит большинству пользователей на старте.

Завершающий шаг регистрации в Postman — настройка команды. Здесь можно указать название команды и пригласить коллег. Если планируете работать один, этот шаг можно пропустить и просто нажать Get Started.

Как установить Postman

Postman доступен в двух вариантах — как веб-версия и как отдельное приложение для компьютера.

  • Веб-версия работает прямо в браузере и не требует установки. Достаточно зарегистрироваться или войти в аккаунт, чтобы сразу начать работу с API.
  • Приложения для Windows, macOS и Linux можно скачать с официального сайта Postman. Установка стандартная, поэтому не будем останавливаться на этом.

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

Интерфейс веб-версии Postman

Главное окно веб-версии Postman условно делится на 4 части.

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

1. Верхнее меню

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

Что в ней есть:

  • Home — стартовая точка, откуда удобно начинать работу. В этом разделе собраны быстрые действия, подсказки и последние рабочие пространства.
  • Workspaces — выпадающий список для переключения рабочих пространств. Здесь можно создать новое рабочее пространство или выбрать существующее. 
  • API Network — встроенный каталог Postman, где собраны публичные API, коллекции и рабочие пространства. Он позволяет быстро находить готовые решения.
  • Поле поиска — глобальный поиск по коллекциям, запросам, окружениям и API внутри вашего аккаунта.
  • Invite — приглашение других пользователей для совместной работы.
  • Уведомления (колокольчик) — показывает оповещения (например, о совместных изменениях).
  • Настройки (шестеренка) — доступ к параметрам профиля и приложения.
  • Аккаунт (аватарка) — управление профилем и выход из учетной записи.
  • Upgrade — переход на платный тариф Postman.

2. Боковая панель

На боковой панели Postman расположены основные инструменты для работы с запросами и проектами:

  • Collections (Коллекции) — место, где хранятся группы запросов. Можно создавать папки и структурировать API-запросы. 
  • Environments (Окружения) — используются для хранения переменных (например, base_url, token) и удобной смены конфигураций.
  • Flows (Потоки) — инструмент для визуального построения сценариев: можно связать несколько запросов в цепочку.
  • History (История) — список всех выполненных запросов с сохранением их параметров и ответов.

Также на панели есть раздел Configure workspace sidebar. В нем можно не только включать или скрывать нужные элементы, но и управлять самим рабочим пространством. В настройках доступны:

  • Workspace settings — выбор типа рабочего пространства, управление участниками и общими настройками.
  • Configure sidebar — включение или скрытие нужных разделов (Collections, Environments, Flows, APIs, Mock servers, Monitors, Specs, Insights, History).
  • Workspace theme — оформление интерфейса.
  • Archive or delete — возможность заархивировать или полностью удалить рабочее пространство.

Мы рекомендуем сразу включить отображение Monitors — это инструмент для автоматической проверки ваших API. Он позволяет запускать коллекции запросов по расписанию, чтобы убедиться, что сервис работает стабильно и отвечает корректно. 

3. Редактор запроса

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

В верхней строке находится два основных элемента:

  • Метод запроса — выпадающий список с вариантами GET, POST, PUT, DELETE и другими HTTP-методами.
  • Поле для URL — сюда вводится адрес API, к которому будет отправлен запрос.

Справа от строки с URL есть несколько полезных кнопок:

  • Send — запускает запрос и отправляет его на сервер.
  • Save — сохраняет текущий запрос в коллекцию, чтобы использовать его в будущем.
  • Share — позволяет поделиться запросом с коллегами.

Чуть ниже находятся вкладки, где задаются детали запроса:

  • Params — таблица с параметрами запроса. Если вы укажете ключ и значение, они автоматически добавятся в строку URL.
  • Authorization — здесь выбирается метод авторизации: токен, ключ, логин/пароль и другие варианты.
  • Headers — можно задать HTTP-заголовки, например, Content-Type или Accept.
  • Body — используется в основном для POST и PUT запросов. Поддерживает разные форматы: JSON, XML, form-data и другие.
  • Scripts — раздел для написания JavaScript-скриптов, которые выполняются либо до отправки, либо после получения ответа.
  • Settings — дополнительные настройки: таймаут, редиректы, прокси.

Кроме этого, здесь же можно просмотреть cookies, которые связаны с выполненными запросами.

4. Область ответа 

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

  • Тело ответа — данные в формате JSON, XML, HTML или текст.
  • Статус — код ответа сервера (200 OK, 404 Not Found, 500 Internal Server Error и так далее).
  • Время выполнения — сколько миллисекунд занял запрос.
  • Размер ответа — объем данных, полученных от сервера.

Кроме того, в здесь можно выбрать:

  • Режим отображения — JSON, XML, HTML, JavaScript; Raw (как есть), Hex (в шестнадцатеричном виде), Base64.
  • Preview — показывает ответ так, как его отобразил бы браузер. Например, если сервер вернул HTML-страницу, вы увидите ее в виде сайта.
  • Vizualize — позволяет превратить данные в таблицы, графики или диаграммы, если для этого задан шаблон визуализации.

Сразу над телом ответа находится строка вкладок:

  • Body — содержимое ответа.
  • Cookies (N) — количество cookie, которые вернулись с ответом.
  • Headers (N) — сколько заголовков пришло.
  • Test Results (N/N) — показывает результат выполнения тестов, если вы прописали их во вкладке Scripts. 

Числа в скобках обновляются с каждым запуском.

Справа от этих вкладок — значок часов. Это History for this request/response. Он открывает список последних ответов для этого запроса, позволяет просматривать предыдущие результаты и сравнивать их с текущим. 

Как использовать Postman для мониторинга API

В качестве примера возьмем набор публичных API — сервисы с фактами о кошках, случайными шутками, публичным IP и изображением NASA. На их основе пошагово разберем, как настроить мониторинг и научиться читать результаты.

Создание коллекции с запросами

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

1. В левой панели Postman выберите раздел Collections.
2. Нажмите кнопку Create New Collection (+) и дайте коллекции название, например: Public APIs.

Через Add a request в боковой панели добавьте в коллекцию четыре запроса (все они типа GET):

  • https://catfact.ninja/fact — возвращает случайный факт о кошках.
  • https://official-joke-api.appspot.com/random_joke — выдает случайную шутку.
  • https://api.ipify.org?format=json — возвращает ваш публичный IP-адрес.
  • https://api.nasa.gov/planetary/apod?api_key=DEMO_KEY — изображение дня от NASA (с описанием).

Для каждого запроса укажите понятное название (например, Get Cat Fact, Get Joke, Get IP, Get NASA APOD) и сохраните его в коллекцию.

2. Проверка запросов вручную

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

Например, при обращении к https://catfact.ninja/fact вы должны получить ответ с кодом 200 OK и JSON вида:

{
    "fact": "Cats walk on their toes.",
    "length": 24
}

 

Если все запросы отрабатывают с кодом 200 и возвращают ожидаемые данные — коллекция готова к следующему шагу.

3. Добавление тестов

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

В каждом запросе перейдите во вкладку Scripts и добавьте JavaScript-код в раздел Post-response. Например: 
 

pm.test("Статус 200", () => {
    pm.response.to.have.status(200);
});
pm.test("Есть факт о кошке", () => {
    const json = pm.response.json();
    pm.expect(json).to.have.property("fact");
});

При каждом запуске Postman будет автоматически проверять, что API возвращает правильный ответ. В результатах теста вы увидите:

Если тесты не пройдут, монитор сразу покажет сбой.

4. Создание монитора

Далее можно запустить автоматический мониторинг. В боковом меню выберите Monitors, а затем — Create new monitor.

Откроется окно с настройками. Здесь нужно задать несколько параметров:

  • Monitor name — придумайте понятное имя, например Public APIs Monitor.
  • Collection — укажите коллекцию, которую мы подготовили ранее.
  • Environment — можно оставить пустым, если вы не используете переменные.
  • Data file (optional) — при необходимости можно загрузить CSV или JSON (до 1 MB), чтобы запускать запросы с разными значениями.

В блоке Run this monitor задается, как часто запускать коллекцию. Можно выбрать периодичность (например, ежедневно или раз в неделю) или указать время запуска (например, каждый день в 1:00 ночи).

На бесплатном тарифе минимальный интервал — 1 час, на платных можно проверять API каждые 5 минут.

Также Postman позволяет выполнять проверки из разных регионов. По умолчанию в блоке Regions включен Automatically select region — автоматический выбор региона. 

Если важно тестировать из определенной точки (например, России), можно переключиться на Manually select region — но на бесплатном тарифе эта функция недоступна.

Отдельно стоит упомянуть Notifications. Чтобы не пропустить проблемы, стоит включить уведомления. Для этого поставьте галочку рядом с опцией Receive email notifications for run failures and errors.

Можно указать до пяти email-адресов для связи. По умолчанию уведомления прекращаются после трех подряд неудачных запусков, но значение можно изменить. 

В Advanced Settings вы найдете дополнительные настройки, где доступны опции:

  • Retry if run fails — повторный запуск при сбое.
  • Set request timeout — ограничение по времени для запросов (по умолчанию 10 минут на бесплатном плане и 15 минут на платных).
  • Set delay before requests — пауза между запросами внутри коллекции.
  • Follow redirects — по умолчанию включено; можно отключить, если редиректы мешают тестированию.
  • Enable SSL validation — проверка подлинности SSL-сертификатов. Если используется самоподписанный сертификат или тестовый сервер, ее можно отключить.

Все заполнив, нажмите Create Monitor и запустите монитор с помощью кнопки Run:

5. Просмотр результатов мониторинга

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

На экране вы увидите сводку последних запусков:

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

Можно переключиться в режим Individual requests и посмотреть статистику отдельно по каждому API:

Кроме того, в Postman есть фильтры, которые помогают анализировать данные:

  • по конкретному запросу (например, только Get NASA APOD);
  • по типу запуска;
  • по результату;
  • по региону.

Для более детальной отладки в Postman есть Console Log. В нем фиксируется всё: запуск коллекций, выполнение скриптов, сетевые ошибки. Логи хранятся до шести месяцев и помогают понять, на каком этапе и почему запрос не выполнился.

Через Activity Feed можно увидеть историю действий: кто создал монитор, кто редактировал или приостанавливал его. 

А в разделе Monitor Details отображаются технические сведения — ID монитора, дата создания, автор и привязанная коллекция.

Готово! 

Теперь у вас есть рабочий монитор, который сам проверяет API и показывает результаты в удобных графиках и логах. Все, что остается — время от времени заглядывать в отчеты и реагировать, если что-то пошло не так.

Рекомендации по эффективному мониторингу API

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

Несколько практических советов, которые могут вам помочь:

  • Не перегружайте коллекцию. Лучше создавать отдельные мониторы для разных групп API (например, публичные сервисы, внутренние микросервисы, интеграции с партнерами). Так будет проще анализировать результаты.
  • Настройте уведомления под себя. Укажите только те адреса, где вы точно будете читать письма. Не забывайте, что Postman может присылать и ежедневные, и еженедельные отчеты — используйте их для анализа.
  • Используйте тесты, а не только статус-коды. Код ответа 200 OK не всегда означает корректную работу. Добавляйте тесты на наличие ключевых полей и проверку их значений, чтобы вовремя обнаружить ошибки в данных.
  • Следите за временем отклика. Мониторинг полезен не только для проверки доступности, но и для оценки производительности. Если API стал отвечать дольше обычного, на это стоит обратить внимание.
  • Работайте с регионами. Если сервис рассчитан на пользователей в разных странах, настройте проверки из нескольких регионов. Это поможет заметить, что API отлично работает из Европы, но тормозит в Азии.
  • Анализируйте историю. Сравнивайте результаты за неделю или месяц. Это поможет найти закономерности — например, регулярные сбои ночью или по понедельникам.
  • Минимизируйте ложные тревоги. Включите опцию повторного запуска при ошибке (Retry if run fails), если еще этого не сделали. Она поможет исключить сбои из-за случайных сетевых проблем.

Заключение

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

Предыдущая статья
Маска подсети: что такое и как узнать по IP
Следующая статья
Обзор Debian