Периодически, в рамках моего 📘 Курса по Postman, мне прилетает вопрос как я организовываю работу с АПИ в Постман на проекте. И пару дней назад вновь подобный вопрос прилетеле и я подумал почему бы не поделится ответом в телеграм-канале.
📁 Общий подход
Я стараюсь выстраивать коллекции как поддерживаемую структуру, а не просто как набор эндпоинтов.
---
📌 Коллекции
🔹 Swagger-коллекцию держу отдельно - как справочную
(через Fork или просто рядом).
🔹 Для тестирования и автоматизации использую отдельные коллекции под реальные бизнес-процессы:
- ориентируюсь на фактические запросы в системе
- сверяюсь с devtools / Charles
- повторяю реальные цепочки вызовов API
👉 Такие коллекции отлично подходят для:
- e2e-проверок
- регресса
- дальнейшей автоматизации (даже в рамках Postman)
---
🗂 Структура внутри коллекции
Запросы группирую по логике процесса, например:
Авторизация → Ресурсы → ДействияТак цепочки читаются последовательно и понятны без лишних комментариев.
---
⚙️ Pre-request scripts
Использую для подготовки данных:
- установка заголовков и токенов
- генерация тестовых данных
- подготовка состояния перед запросом
🔁 Общую логику выношу:
- на уровень коллекции
- или папок
В самих запросах оставляю только специфичную часть.
---
✅ Post-response (Tests)
В test-скриптах:
- проверяю ответы
- сохраняю данные для следующих шагов (токены, id ресурсов и т.д.)
Использую:
- collection variables
- environment variables
---
🧩 Переменные
🟢 Окружение - параметры среды (baseUrl, токены, конфигурация)
🟡 Коллекция - данные конкретного сценария
🔴 Глобальные переменные - не использую
---
♻️ Рефакторинг и отладка
Всё, что начинает дублироваться -
👉 выношу в общие скрипты.
Для отладки обязательно использую
console.log, особенно:- при запуске e2e-цепочек
- чтобы понять что, где и на каком шаге упало
🌐 Сайт | 💼 LinkedIn | 📘 Курс по Postman