🧠 Как я организую скрипты и коллекции в Postman

🧠 Как я организую скрипты и коллекции в Postman

Периодически, в рамках моего 📘 Курса по 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