Середовище
Змінні середовища зберігають значення для повторного використання в запитах у розділах «Повторне надсилання», «Автоматизація» й «Робочі процеси».
Створення й редагування змінних
- Відкрийте Середовище в лівій панелі навігації.
- Натисніть Додати змінну.
- Введіть ім’я, що починається з літери або підкреслення й далі містить літери, цифри, підкреслення або дефіси (не більше ніж 64 символи).
- Введіть значення.
- Увімкніть Секретна, якщо значення конфіденційне (ключі API, токени, паролі). Секретні значення приховуються в інтерфейсі й не потрапляють у контекст ШІ.
- Натисніть Зберегти.
Щоб змінити наявну змінну, натисніть її рядок і оновіть ім’я або значення.
Використання змінних у запитах
Посилайтеся на змінну середовища з префіксом env.:
{{env.VARIABLE_NAME}}Приклади:
- Поле хоста:
{{env.TARGET_HOST}}(зберігайте ім’я хоста, а не повний URL). - Заголовок Authorization:
Bearer {{env.AUTH_TOKEN}}. - Тіло запиту:
{"tenant": "{{env.TENANT_ID}}"}; увімкніть шаблонізацію тіла в розділі «Повторне надсилання», якщо потрібні підстановки всередині тіла.
Ogma підставляє коректні змінні середовища під час надсилання. Відсутня змінна спричиняє помилку замість непомітного надсилання непідставленого значення. Надсилання в режимах «Необроблений» і «Шістнадцятковий» зберігає точні байти й не підставляє значення змінних.
Область дії змінних
Виберіть Глобальна для значень, спільних для проєктів цього робочого простору Ogma, або Проєкт для значень активного проєкту. Значення проєкту перевизначають однойменні глобальні значення. Повторне надсилання також підтримує перевизначення на рівні колекції й сеансу; пріоритет такий: сеанс, колекція, проєкт, глобальна змінна.
Перетворення й динамічні значення
Додавайте перетворення через вертикальну риску, наприклад {{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 |