Окружение
Переменные окружения хранят значения для повторного использования в запросах Replay, Automate и рабочих процессов.
Создание и редактирование переменных
- Откройте Окружение в левой панели навигации.
- Нажмите Добавить переменную.
- Введите имя, начинающееся с буквы или подчёркивания, за которым следуют буквы, цифры, подчёркивания или дефисы (не более 64 символов).
- Введите значение.
- Включите Секрет, если значение конфиденциально (ключи API, токены, пароли). Секретные значения скрываются в интерфейсе и исключаются из контекста ИИ.
- Нажмите Сохранить.
Чтобы изменить существующую переменную, нажмите её строку и обновите имя или значение.
Использование переменных в запросах
Ссылайтесь на переменную окружения с префиксом env.:
{{env.VARIABLE_NAME}}Примеры:
- Поле хоста:
{{env.TARGET_HOST}}(сохраните имя хоста, а не полный URL). - Заголовок авторизации:
Bearer {{env.AUTH_TOKEN}}. - Тело запроса:
{"tenant": "{{env.TENANT_ID}}"}; включите шаблонизацию тела в Replay, если нужны подстановки внутри тела.
Ogma подставляет значения корректных переменных окружения при отправке. Отсутствующая переменная вызывает ошибку, а не незаметную отправку неподставленного значения. Отправка из Raw и Hex в Replay сохраняет точные байты без подстановки значений в шаблоны.
Область действия переменных
Выберите Глобальная для значений, общих для проектов рабочего пространства Ogma, или Проект для значений активного проекта. Переменные проекта переопределяют одноимённые глобальные переменные. Replay также поддерживает переопределения коллекции и сессии; приоритет: сессия, коллекция, проект, затем глобальная переменная.
Преобразования и динамические значения
Добавляйте преобразования через вертикальную черту, например {{env.AUTH_TOKEN|base64_encode}} или {{env.SEARCH|url_encode}}. Цепочка применяется слева направо. Проверьте результат тестовым запросом: неизвестные имена преобразований пропускаются без сообщения об ошибке.
Для встроенных значений сохранять переменную не нужно:
| Шаблон | Значение |
|---|---|
{{$timestamp}} | Текущее время Unix в миллисекундах. |
{{$timestamp_s}} | Текущее время Unix в секундах. |
{{$uuid}} | Новый UUID. |
{{$random(16)}} | 16 случайных байт в шестнадцатеричном представлении. |
{{$date(%Y-%m-%d)}} | Текущая дата UTC по шаблону формата даты. |
В сохранённых значениях не выполняется рекурсивная подстановка. Если значение содержит другой шаблон, этот вложенный текст остаётся без изменений.
Доступ ИИ-помощника
ИИ-помощник может читать имена и значения несекретных переменных для контекста, когда вы просите проанализировать запрос или составить план тестирования. Секретные переменные никогда не включаются в контекст ИИ.
Типичные применения
| Переменная | Пример значения |
|---|---|
BASE_URL | https://api.example.com |
AUTH_TOKEN | eyJhbGci... (пометьте как секрет) |
TARGET_HOST | app.example.com |
API_KEY | sk-... (пометьте как секрет) |
USER_ID | 12345 |