Download Postman

Download the app to get started using the Postman API Platform today. Or, if you prefer a browser experience, you can try the web version of Postman.

The Postman app

Download the app to get started with the Postman API Platform.

By downloading and using Postman, I agree to the Privacy Policy and Terms.

Download the App To experience the best the Postman app has to offer, please download it on your desktop.

Not your OS? Download for Windows (x64) or Linux (x64, arm64)

Postman on the web

Access the Postman API Platform through your web browser. Create a free account, and you’re in.

Postman Enterprise

Postman Enterprise is designed for organizations who need to deploy Postman at scale.

Postman VS Code extension

Early access!

The Postman VS Code extension, which is developed and supported by Postman, is in early access. Bring Postman closer to your development workflow and send API requests from within VS Code—now with support for collections and environments.

Postman desktop agent

If you are using the Postman web client, you will need to also download the Postman desktop agent. The Postman agent overcomes the Cross-Origin Resource Sharing (CORS) limitations of browsers, and facilitates API request sending from your browser version of Postman. Read the blog post.

Postman CLI

The Postman CLI is the command-line companion that is developed, supported, and signed by Postman. It enables you to run collections, lint API schemas, run security and governance checks, and log in and out. All test results will be automatically pushed to the app.

Windows installation

powershell.exe -NoProfile -InputFormat None -ExecutionPolicy AllSigned -Command "[System.Net.ServicePointManager]::SecurityProtocol = 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://dl-cli.pstmn.io/install/win64.ps1'))"

Mac (Apple silicon) installation

curl -o- "https://dl-cli.pstmn.io/install/osx_arm64.sh" | sh

Mac (Intel) installation

curl -o- "https://dl-cli.pstmn.io/install/osx_64.sh" | sh

Linux installation

curl -o- "https://dl-cli.pstmn.io/install/linux64.sh" | sh

Postman

Postman — это HTTP-клиент для тестирования API. HTTP-клиенты тестируют отправку запросов с клиента на сервер и получение ответа от сервера.

API (Application Programming Interface) — это интерфейс для обмена данными с сервера между двумя приложениями или компонентами ПО. Тестировщикам Postman помогает в проектировании дизайна API и создании mock-серверов (имитаторов работы приложения). Например, с помощью Postman можно протестировать, как API регистрирует нового пользователя приложения, как добавляет и удаляет данные о нем на сервере.

Использование Postman

С помощью Postman тестировщик может:

• составлять и отправлять HTTP-запросы к API;
• создавать коллекции (набор последовательных запросов) и папки запросов для сокращения времени тестирования;
• менять параметры запросов (например ключи авторизации и URL);
• менять окружения для запросов (например на тестовом стенде, локально или на сервере);
• добавлять при вызове API контрольные точки (фиксацию момента передачи данных);
• проводить автоматизированное тестирование API по коллекции запросов с помощью Collection Runner.

Профессия / 16 месяцев
Тестировщик-автоматизатор

Лучший выбор для быстрого старта в IT

Для работы с серверами программа использует протокол HTTP. Тестировщик отправляет тестовые запросы от клиента на сервер и получает ответ, есть ли ошибка в работе API.

Postman доступен в виде приложения для Windows, Linux и macOS, а также в web-интерфейсе (для его работы нужно установить программу Postman Desktop Agent). Вот как выглядит работа с коллекциями запросов:

1. Коллекция запросов для теста API. Внутри коллекции запросы можно объединять в папки.
2. Вкладка запроса из коллекции.
3. Выбор метода для запроса (GET, POST, PUT, DELETE).
4. URL запроса на сервере.
5. Кнопка отправки запроса.
6. Выбор параметров запроса (ключи и значения — например, только удаленные объекты).
7. Результат выполнения запроса (код, тело и время ответа, а также размер полученных данных).

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

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

Для автоматизированных тестах к коллекциям, папкам и запросам можно применять скрипты на JavaScript. Например, с помощью скриптов можно использовать результат выполнения одного запроса как условия для другого.

Станьте тестировщиком – это лучший выбор для быстрого старта в IT

Методы Postman

Чаще всего в работе API используется архитектура RESTful. В этой архитектуре есть четыре стандартных метода запросов к серверам по HTTP:

• POST — создание объекта и отправка данных на сервер;
• GET — получение информации с сервера;
• PUT — обновление объекта;
• DELETE — удаление объекта.

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

• 1xx
  • Информация
  • Информирование о статусе передачи данных
  • Успех
  • Запрос выполнен успешно
  • Перенаправление
  • Запрос может быть успешно выполнен, но по другому URL
  • Ошибка клиента
  • Указание на ошибку на стороне клиента, из-за которой запрос нельзя выполнить
  • Ошибка сервера
  • Указание на ошибку на стороне сервера, из-за которой он не может обработать запрос
  • Указание на ошибку на стороне сервера, из-за которой он не может обработать запрос

  Читайте также Как выбрать IT-специальность в новых реалиях?

  Примеры запросов

  Вот пример тестирования запроса, который получает идентификатор пользователя от сервера, — GET user id .

  1. Создайте коллекцию. Дайте ей имя, например Useridtest. Откройте вкладку для запроса: он будет сохранен в этой коллекции.
  2. Введите URL запроса. Для обучения можно использовать открытую документацию от разработчиков Postman. Для возврата идентификатора пользователя подойдет URL https://postman-echo.com/get?userId=333. Во вкладке Params автоматически появятся параметры запроса — userid.
  3. Выберите метод запроса. Для получения идентификатора пользователя нужен метод GET.
  4. Отправьте запрос. Нажмите кнопку Send — Postman отправит запрос на свой echo-сервер для учебных запросов.
  5. Получите ответ. Программа выведет тело ответа (программный код) в окно Response, а код статуса появится в меню выше. В учебном примере запрос выполнится успешно: код примет значение 200.

  Документация и полезные ссылки

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

  Краткий курс по тестированию API с помощью Postman на YouTube.

  7 курсов для изучения Postman на Udemy, Coursera и Pluralsight.

  Тестировщик-автоматизатор

  Как ворваться в IT, даже если вы не умеете программировать? Стать тестировщиком. Для старта достаточно базовых знаний ПК. А начать работать можно уже через 4 месяца обучения.

  

  Статьи по теме:

  Как пользоваться программой Postman

  

  Программа Postman предназначена для тестирования работы API, а также для отправки запросов POST и GET. В отличие от похожей утилиты curl, она имеет графический интерфейс, поэтому легко осваивается даже новичками.

  Скачать ее можно с официального сайта – есть дистрибутивы для Windows, macOS и Linux. На последней платформе есть возможность установки утилиты напрямую из Центра приложений. В любом случае использование начинается с регистрации бесплатного аккаунта.

  Как тестировать API

  Тестирование интерфейса API проводится путем анализа точности выходных данных в зависимости от подаваемых при входном запросе. Этим и занимается Postman: он составляет и отправляет их на указанные URL, получает обратно и сохраняет в базе данных. При желании возможно сохранение типовых запросов в коллекции (для быстрого доступа) и создание для них разного окружения.

  Комьюнити теперь в Телеграм
  Подпишитесь и будьте в курсе последних IT-новостей

  Интерфейс приложения Postman

  Главное окно программы разделено на четыре области. Разделение на блоки идет по функционалу, что заметно упрощает настройку и управление. Если опыта работы с такими утилитами нет, рекомендуется не трогать непонятные пункты, а пользоваться только простыми (их мы и рассмотрим).

  

  1. Верхняя панель – здесь расположены основные настройки программы.
  2. Боковая панель – сюда выделены запросы, выполненные ранее или сохраненные в качестве «избранного».
  3. Панель вкладок – инструмент переключения между разными запросами.
  4. Рабочая область – все базовые настройки отправленного запроса, перечень возвращаемых по нему данных.

  Выполнение запроса

  Выполнение простого запроса, без сохранения в коллекции, осуществляется кликом по кнопке со значком . В результате откроется новая вкладка, где есть возможность выбрать тип запроса (GET или POST) и внести домен, который будет открываться. Остается нажать на кнопку Send, которая и запустит процедуру проверки.

  

  В нижней части страницы появится код страницы (HTML). Здесь имеется несколько вкладок:

  1. Body – данные, содержащиеся в теле запроса.
  2. Cookie – информация, записанная сервером.
  3. Headers – заголовки, которые были возвращены.

  На первой вкладке, где отображается тело запроса, есть выбор нескольких вариантов отображения. Так, Pretty интересна для получения JSON-данных – программа отформатирует их в достаточно удобном формате. Если выбрать режим Raw, информация будет представлена «как есть», без каких-либо изменений. Вкладка Preview отображает сайт в том виде, в котором он открывается в браузере.

  Передача параметров в Postman

  В программу встроен собственный сервис API, который и используется для тестирования внешних ресурсов. Чтобы обратиться к нему, следует кликнуть на «плюсик», выбрать из выпадающего списка тип запроса GET, а вместо домена вставить ссылку на сервис https://postman-echo.com/get.

  

  Затем нужно открыть вкладку Params и в разделе Query Params под строкой Key внести название отправляемого параметра. Следом под строкой Value нужно написать еще одно значение. Количество не ограничено – пользователь вносит столько параметров, сколько ему нужно для тестирования конкретного API.

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

  Передача параметров формы и заголовков

  В отличие от GET, запрос POST передается не в ссылке на сайт, а в теле запроса. Чтобы проверить работоспособность программы, используется обращение к адресу https://postman-echo.com/post. Во время настройки на вкладке Body нужно включить режим form-data, затем внести схожие параметры и нажать на кнопку Send.

  

  Если взаимодействие по API требует передачи токенов авторизации, понадобится привлечь к этому HTTP-заголовки. Такой формат работы используется, например, в движке Xenforo, написанном на PHP для развертывания форумов. Для передачи в заголовке какой-либо информации нужно зайти на вкладку Headers и добавить любое имя со значением (на выбор пользователя). После отправки информации внизу окна будет отображен ответ сервера.

  Передача файла в Postman

  Программа Postman позволяет отправлять файлы, а не только текстовые данные, как в приведенных выше примерах. Чтобы сделать это, достаточно перейти на вкладку Body, зайти в раздел form-data и выбрать тип параметра File (вместо Text).

  

  Затем следует нажать на кнопку Select File и выбрать отправляемый файл. После отправки данных на сервер он будет виден в секции files. Ничего сложного в процедуре нет, приведенная выше схема работает со всеми типами файлов.

  Авторизация Basic Auth

  Если на сайте используется защита с авторизацией по методу Basic Auth, программа Postman дает возможность проверить ее прохождение. В качестве примера обращение будет осуществляться по адресу https://postman-echo.com/basic-auth. Чтобы пройти проверку, понадобится отправить значение имени пользователя postman и пароль доступа password.

  

  Далее в рабочей области надо открыть вкладку Authorization, в разделе Type выбрать значение Basic Auth и заполнить имя с паролем. Если процедура пройдена успешно, тестовый сервер вернет ответ authenticated: true.

  История и коллекция запросов

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

  

  Наиболее важные запросы рекомендуется сохранять в коллекции. Чтобы сделать это, достаточно нажать на кнопку New на верхней панели, выбрать пункт Collection и ввести название (на выбор пользователя). Теперь любой запрос будет добавлен в перечень нажатием на кнопку Create и, после заполнения всех данных, кнопку Save (до отправки на сервер).

  При подготовке материала использовались источники:
  https://www.postman.com/downloads/

  Postman

  
  https://timeweb.com/ru/community/articles/kak-polzovatsya-postman