Основні поняття
Щойно ці чотири рішення стануть зрозумілими, усі наступні протоколи та сценарії будуть простими:
- Модель трьох сутностей: як пов'язані Група / Середовище / Запит
- Дизайн Pre-URL середовища: чому запити зберігають лише відносні шляхи
- Конвеєр складання відправки: як одна відправка перетворює конфігурацію на справжній запит
- Система змінних: звідки резолвиться
{{variable}}і які три шари змінних існують
Модель трьох сутностей
Чому середовище прив'язується до групи, а не до кожного запиту? Група зазвичай означає «усі API одного модуля в межах одного середовища розгортання». Прив'язка на рівні групи означає, що перемикання середовища переносить одразу всю групу — без редагування кожного запиту окремо. Якщо окремому запиту потрібне інше середовище, просто покладіть його в групу, прив'язану до того середовища.
Дизайн Pre-URL середовища
Це найважливіший — і найчастіше неправильно зрозумілий — дизайн.
Запити зберігають відносні шляхи; середовища зберігають базові адреси
У традиційних інструментах кожен запит зберігає повний URL (https://api.example.com/v1/users), тому перехід на тестове середовище означає масову заміну доменів. Цей інструмент усе перевертає:
Схема визначає протокол і TLS (ключово!)
Pre-URL зберігаються для кожного протоколу окремо, але який протокол фактично обслуговує запис, вирішує схема на початку URL. Схема виражає одночасно «який протокол» і «зашифровано чи ні (TLS)»:
| Протокол | Звичайна схема | Шифрована схема |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ Типова помилка: базову адресу WebSocket треба записувати як
ws:///wss://. Якщо ввестиhttps://, її буде розцінено як HTTP, і запит WebSocket не вдасться виконати через відсутність базової адреси. Тримайте рядок протоколу та схему узгодженими.
Конвеєр складання відправки
Натискання «Send» не запускає сокет напряму. Конвеєр покроково складає «запит + середовище групи + змінні» у справжній запит і вставляє ланцюжок дій до та після мережевого виклику:
Ключові моменти:
- Ланцюжки дій виконуються лише коли ввімкнено «execute scripts». Натискання Send у застосунку запускає їх усталено; автоматичні / MCP-відправки мають явно це дозволити. Якщо скрипти вимкнено, токени, ін'єктовані перед відправленням, або шифрування просто не відбуваються — саме тому негативний контроль «немає токена → 401» у recipes поводиться саме так.
- Скрипти перед відправленням переписують запит, який лише має вийти; скрипти після відповіді переписують отриману відповідь. Обидва можуть читати й писати змінні часу виконання.