Перейти до основного вмісту

Основні поняття

Щойно ці чотири рішення стануть зрозумілими, усі наступні протоколи та сценарії будуть простими:

  1. Модель трьох сутностей: як пов'язані Група / Середовище / Запит
  2. Дизайн Pre-URL середовища: чому запити зберігають лише відносні шляхи
  3. Конвеєр складання відправки: як одна відправка перетворює конфігурацію на справжній запит
  4. Система змінних: звідки резолвиться {{variable}} і які три шари змінних існують

Модель трьох сутностей​

Чому середовище прив'язується до групи, а не до кожного запиту? Група зазвичай означає «усі API одного модуля в межах одного середовища розгортання». Прив'язка на рівні групи означає, що перемикання середовища переносить одразу всю групу — без редагування кожного запиту окремо. Якщо окремому запиту потрібне інше середовище, просто покладіть його в групу, прив'язану до того середовища.


Дизайн Pre-URL середовища​

Це найважливіший — і найчастіше неправильно зрозумілий — дизайн.

Запити зберігають відносні шляхи; середовища зберігають базові адреси​

У традиційних інструментах кожен запит зберігає повний URL (https://api.example.com/v1/users), тому перехід на тестове середовище означає масову заміну доменів. Цей інструмент усе перевертає:

Схема визначає протокол і TLS (ключово!)​

Pre-URL зберігаються для кожного протоколу окремо, але який протокол фактично обслуговує запис, вирішує схема на початку URL. Схема виражає одночасно «який протокол» і «зашифровано чи ні (TLS)»:

ПротоколЗвичайна схемаШифрована схема
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://mqtts://

⚠️ Типова помилка: базову адресу WebSocket треба записувати як ws:// / wss://. Якщо ввести https://, її буде розцінено як HTTP, і запит WebSocket не вдасться виконати через відсутність базової адреси. Тримайте рядок протоколу та схему узгодженими.


Конвеєр складання відправки​

Натискання «Send» не запускає сокет напряму. Конвеєр покроково складає «запит + середовище групи + змінні» у справжній запит і вставляє ланцюжок дій до та після мережевого виклику:

Ключові моменти:

  • Ланцюжки дій виконуються лише коли ввімкнено «execute scripts». Натискання Send у застосунку запускає їх усталено; автоматичні / MCP-відправки мають явно це дозволити. Якщо скрипти вимкнено, токени, ін'єктовані перед відправленням, або шифрування просто не відбуваються — саме тому негативний контроль «немає токена → 401» у recipes поводиться саме так.
  • Скрипти перед відправленням переписують запит, який лише має вийти; скрипти після відповіді переписують отриману відповідь. Обидва можуть читати й писати змінні часу виконання.

Система змінних​

Є три види «змінних» з різними областями видимості. Плутанина між ними — найпоширеніша пастка початківця.

Що насправді може резолвити {{name}}?​

Де записаноЗмінні середовищаЗмінні часу виконанняТипове використання
{{name}} (у URL / params / headers / body)✅❌Посилання на конфігурацію середовища, динамічне заповнення
Читання змінних усередині скриптів✅✅Передавання токенів входу між запитами тощо

Мнемоніка: {{}} бачить лише «конфігураційні» змінні; скрипти можуть читати всі три шари. Змінні часу виконання — це «дошка часу виконання»: писати на ній можуть лише скрипти, і {{}} туди ніколи не заглядає.

Чому {{authToken}} не читає токен, збережений при вході? Тому що скрипт входу зберіг його в шарі часу виконання, який {{}} не розбирає. Правильний підхід — скрипт перед відправленням, який читає його та ін'єктує заголовок (див. recipes, сценарій 1).

Динамічні змінні {{$xxx}}​

Усередині {{}} є також набір вбудованих динамічних змінних, що генеруються заново за кожного обчислення, придатних безпосередньо в URL / params / headers / body:

ЗміннаГенерує
{{$timestamp}} / {{$timestampMs}}Мітка часу Unix у секундах / мілісекундах
{{$isoTimestamp}}ISO8601 UTC
{{$uuid}} / {{$guid}}UUID v4
{{$randomInt}} / {{$randomInt min,max}}Випадкове ціле (усталено 0..1000)
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} тощоРізноманітні випадкові зразки даних

Приклад: GET /echo?ts={{$timestamp}}&u={{$uuid}} — на практиці кожна відправка замінює ts/u свіжими реальними значеннями.


Підсумок​

  • Запити зберігають фрагменти шляху; середовища дають базові адреси для кожного протоколу через Pre-URL; схема визначає протокол і TLS.
  • Відправка — це конвеєр складання: зібрати URL → інтерполювати змінні → налаштування транспорту → ланцюжок перед відправленням → мережа → ланцюжок після відповіді.
  • Змінні мають три шари: {{}} читає конфігураційні змінні, скрипти читають усі три; передавайте токени скриптами, а не {{}}.

Далі: scripting →