Під час роботи з API виникає потреба мати різні налаштування змінних, для різних оточень (наприклад локальна машина, тестовий сервер, продуктовий сервер).
Postman environments надають можливість налаштовувати запити до різних середовищ одного API за допомогою змінних. Завдяки цьому, можна легко перемикатися між різними налаштуваннями, не змінюючи свої запити.
Створення Environment Postman
Для створення нового середовища в Postman, потрібно перейти в розділ Environments та натиснути символ +:
Після додавання нового середовища є можливість задати його назву. В мене для прикладу буде Test Environment:
Додавання змінних до Environment
Наступним кроком буде додавання змінних середовища:
- Variable – ім’я змінної, знадобиться для подальшого використання
- Type – якщо обрано default, значення змінної буде відображатись під час перегляду. Якщо вибрати secret, значення змінної маскується (бажано використовувати для конфіденційних даних)
- Initial value (shared) – є загальнодоступним для всіх користувачів, хто має доступ до середовища. Саме Initial value буде оприлюднено, в разі публікації середовища разом з колекцією
- Current value (local) – використовується під час надсилання запитів у вашому локальному Postman. Якщо Current value залишити порожнім, в нього автоматично буде скопійовано значення з Initial value, під час збереження середовища
Для прикладу додам ще кілька змінних з типом secret:
Після додавання/редагування змінних середовища, потрібно натиснути кнопку Save.
Перемикання між Environments Postman
Postman відображає поточне активне середовище в селекторі середовищ:
Для зміни середовища, достатньо просто обрати необхідне зі спадаючого списку:
Для швидкої перевірки та перегляду змінних активного середовища, потрібно натиснути на піктограму біля селектора середовищ:
Використання змінних в запитах та скриптах
Синтаксис використання змінних в Postman:
{{variable_name}}Я створив приклад запиту до свого вигаданого API, для демонстрації використання змінних Test Environment:
Якщо переглянути cURL згенерований на основі мого запиту, можна помітити підставлені значення змінних з Test Environment (значення login та password приховані, через те що мають тип secret).
Для доступу до змінних середовища в Pre-request або Tests скриптах, потрібно скористатися викликом:
pm.environment.get("variable_name");Посилатися на змінні середовища можна в URL-адресах, параметрах, headers та body запиту.
Редагування Environment
Для редагування середовища в Postman, потрібно перейти в розділ Environments, обрати необхідне середовище та натиснути піктограму з трьома крапками. Відкриється меню з вибором опцій:
