8.2 Коллекции в Postman

В этой лекции разберем, что такое коллекции в Postman, для чего они нужны и какой функционал несут.

Напомним, с помощью запроса POST можно создать новую сущность, к примеру, нового пользователя. С помощью GET можем получить по нему информацию. С помощью запроса PUT можно изменить информацию по пользователю. А с помощью запроса DELETE можно удалить данного пользователя.

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

Что такое и для чего необходимы коллекции?

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

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

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

Почему нельзя держать одну коллекцию?

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

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

Как создавать коллекции?

В Postman в Workspace нужно нажать на плюс:

Далее создаем новую коллекцию и как-нибудь ее называем:

Разберемся с вкладками, для чего они нужны:

1. Overview - позволяет заполнять информацию по коллекции. То есть можно нажать на карандаш и написать любую информацию, которая может помочь при работе с коллекцией.
2. Authorization - вкладка авторизации.
   Для того, чтобы отправить некоторые запросы, нужно быть авторизованным в системе.
   Например, когда заходим в почтовый сервис для того, чтобы отправить письмо, необходимо авторизоваться. То есть нельзя отправить письмо если нет входа в систему.
   Если настроить авторизацию на этой вкладе, тогда перед тем, как отправить запрос, система будет проверять, что авторизация пройдена и только после этого будет отправлять запрос.
3. Pre-reauest Script - эта вкладка содержит специальные скрипты, которые будут выполняться перед тем, как отправить тот или иной запрос. То есть указываются условия, которые будут происходить до запроса.
4. Tests - вкладка со скриптами, которые будут выполняться после теста. Т.е. в данной вкладке будут размещаться определенные проверки на статус-код, на содержание полей и тд. Здесь будут содержаться тесты, которые нужно провести при тестировании API.
   Можно не просто отправлять запрос и получать код 200. Можно проводить различные проверки, например, на содержимое полей (что получено то значение, которое и должно быть получено).
5. Veriables - вкладка для создания переменных, которые будут использоваться в запросах.
   Можно делать в них публичные или закрытие значения.
   Закрытие значения - значения, которыми пользуется только один тестер.
   Публичные значения - значения, которыми могут пользоваться все члены команды.
6. Runs - вкладка, с помощью которой можно запускать все запросы, которые содержаться в коллекции.
   Например, в коллекция включает в себя запросы: 1) Создание физического лица; 2) Получение информации о физическом лице; 3) Изменение информации по физическому лицу; 4) Удаление физического лица. С помощью данной вкладки можно запустить все эти запросы поочередно.