Классические рецепты сценариев
Комбинируйте concepts и scripting в реальные рабочие процессы. Каждый сценарий дает: цель → поток → скрипты, которые можно вставить прямо в UI → ожидаемый результат. Вся логика скриптов проверена сквозным образом в реальн ом приложении.
- Сценарий 1: вход для получения токена, автоподстановка для всей группы
- Сценарий 2: шифрование тела запроса AES, расшифровка ответа (цепочка из нескольких скриптов)
- Сценарий 3: извлечение · проверки · динамические переменные · подпись
- Сценарий 4: повторное использование общей логики с библиотечными скриптами и
require()
Примеры используют локальный тестовый сервер (
/oauth2/token,/protected,/echo,/jsonи т.д.). При работе со своими API подставьте свои пути и Pre-URL.
Сценарий 1: вход для получения токена, автоподстановка для всей группы
Цель: вызвать API входа, сохранить токен и сделать так, чтобы все последующие запросы прикрепляли его автоматически — без ручного копирования.
Запрос A — вход (скрипт после ответа сохраняет токен)
POST /oauth2/token, form-тело: grant_type=password&username=qruser&password=qrpass&client_id=qr-client&client_secret=qr-secret
Добавьте один шаг скрипт в цепочку после ответа:
async function onResponse(context, url, response) {
var j = response.body.parseJSON();
if (j && j.access_token) {
sdk.env.set('authToken', j.access_token); // store on the runtime blackboard
sdk.env.set('tokenType', j.token_type || 'Bearer');
}
return response;
}
Запрос B — прикрепление токена (тот же скрипт можно скопировать в каждый авторизованный API)
GET /protected, добавьте один шаг скрипт в цепочку перед отправкой:
async function onRequest(context, url, request) {
var tok = sdk.env.get('authToken'); // take from the blackboard
var ty = sdk.env.get('tokenType') || 'Bearer';
if (tok) { request.headers.set('Authorization', ty + ' ' + tok); }
return request;
}
Ожидаемый результат
| Действие | Результат |
|---|---|
| Сначала отправить A (вход) | 200, ответ содержит access_token, токен сохранен |
| Затем отправить B (прикрепление) | 200, ответ {authorized:true, ...} |
| Отключить скрипты и снова отправить B | 401 (цепочка перед отправкой не выполняется → токен не внедрен — доказательство, что именно скрипт прикрепляет его) |
Ключевое: A и B должны находиться в одной группе, привязанной к одному окружению (переменные runtime действуют в рамках окружения), а фрагменты пути достраиваются Pre-URL окружения.
Сценарий 2: шифрование тела запроса AES, расшифровка ответа (цепочка и з нескольких скриптов)
Цель: шифровать тело AES перед отправкой (в сети только шифротекст), расшифровывать ответ после получения; также демонстрирует цепочку из нескольких скриптов и обмен данными между ними.
Почему можно разделить на несколько скриптов? Скрипты одной цепочки разделяют
globalThis: скрипт ① прячет ключи/plaintext, скрипты ②③ их подхватывают. Каждый скрипт остается однозадачным и может включаться/выключаться независимо.
Цепочка перед отправкой
Скрипт ① (готовит контекст и ключи):
async function onRequest(context, url, request) {
globalThis.__traceId = $uuid.v4();
globalThis.__aesKey = '0123456789abcdef'; // 16 bytes → AES-128
globalThis.__aesIv = 'abcdef0123456789';
globalThis.__plain = request.body.parseText();
request.headers.set('X-Trace-Id', globalThis.__traceId);
return request;
}
Скрипт ② (шифрует тело):
async function onRequest(context, url, request) {
var cipher = $crypto.encryptAES(globalThis.__plain, globalThis.__aesKey, globalThis.__aesIv);
request.body = cipher; // only ciphertext on the wire
request.headers.set('X-Encrypt', 'AES-128-CBC');
return request;
}
(Опционально) скрипт ③ добавляет логику прикрепления токена из Сценария 1.