Перейти к основному содержимому

Ключевые концепции

Когда эти четыре решения станут понятны, все последующие протоколы и сценарии окажутся простыми:

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

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

Почему окружение привязывается к группе, а не к каждому запросу? Группа обычно представляет «все API одного модуля под одной целью развертывания». Привязка на уровне группы означает, что смена окружения перемещает всю группу разом — без правок по каждому запросу. Если одному запросу нужно другое окружение, просто поместите его в группу, привязанную к этому окружению.


Структура Pre-URL окружения​

Это самое важное — и чаще всего неправильно понимаемое — решение.

Запросы хранят относительные пути; окружения хранят базовые адреса​

В традиционных инструментах каждый запрос хранит полный URL (https://api.example.com/v1/users), поэтому переход на тестовое окружение означает массовую замену доменов. Этот инструмент переворачивает подход:

Схема (scheme) определяет протокол и TLS (важно!)​

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

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

⚠️ Частая ошибка: базовый адрес WebSocket должен записываться как ws:// / wss://. Если ввести https://, он будет обработан как HTTP, и запрос WebSocket не найдет базовый адрес и упадет. Держите строку протокола и схему согласованными.


Конвейер сборки отправки​

Нажатие «Отправить» не открывает сокет напрямую. Конвейер шаг за шагом собирает «запрос + окружение группы + переменные» в реальный запрос и вставляет цепочку действий до и после сетевого вызова:

Ключевые моменты:

  • Цепочки действий выполняются только при включенной опции «выполнять скрипты». Нажатие «Отправить» в приложении запускает их по умолчанию; автоматические / MCP-отправки должны включать их явно. Со скриптами выключенными токены, внедряемые перед отправкой, или шифрование просто не сработают — именно поэтому негативный контроль «нет токена → 401» в recipes ведет себя именно так.
  • Скрипты перед отправкой переписывают запрос, который вот-вот уйдет; скрипты после ответа переписывают полученный ответ. Оба могут читать и писать runtime-переменные.

Система переменных​

Есть три вида «переменных» с разными областями действия. Перепутать их — самая частая ловушка новичка.

Что на самом деле разрешает {{name}}?​

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

Мнемоника: {{}} видит только «конфигурационные» переменные; скрипты читают все три слоя. Переменные runtime — это «доска runtime»: писать в нее могут только скрипты, и {{}} туда никогда не заглядывает.

Почему {{authToken}} не может прочитать токен, сохраненный при входе? Потому что скрипт входа положил его в слой runtime, который {{}} не разбирает. Правильный подход — скрипт перед отправкой, который читает его и вставляет заголовок (см. 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 → интерполировать → настройки транспорта → цепочка перед отправкой → сеть → цепочка после ответа.
  • Переменные бывают трех слоев: {{}} читает конфигурационные переменные, скрипты читают все три; передавайте токены скриптами, а не {{}}.

Далее: скрипты →