API сессий встраивания
POST /v1/embed/sessions — открывает встраиваемый редактор для одного из ваших конечных пользователей в его подпространстве; отзыв сессий. Только на стороне сервера.
Только в режиме партнёра (руководство). Вызывайте его со своего сервера с вашим API-ключом.
POST https://api.dcision.io/v1/embed/sessions| Поле | Тип | |
|---|---|---|
workspace | string или object | ext:<external_id> / id подпространства или { "external_id", "name", … }, чтобы создать его на лету (те же поля, что у POST /v1/workspaces) |
user | object | Обязательное. { "id", "name"?, "email"? } — ваш конечный пользователь |
permissions | string[] | По умолчанию: все. decisions:read, decisions:write, decisions:deploy, decisions:delete, executions:read, agent |
start_path | string | /decisions (по умолчанию), /decisions/new или /decisions/{id}[/editor|builder|playground|deploy|executions] |
origins | string[] | Подмножество ваших разрешённых источников (по умолчанию: все). Сессии тестовых ключей также могут использовать локальный источник для разработки |
locale | string | en, pt, es, ru или zh |
theme | string | light, dark или system |
ttl_seconds | integer | 300–43 200 (по умолчанию 3 600) |
{
"id": "emb_7Hq2Lm9Xc4Rv1Tz8Wn3B",
"url": "https://app.dcision.io/embed/launch?ticket=emt_…",
"launch_expires_at": "2026-10-09T12:01:00.000Z",
"expires_at": "2026-10-09T13:00:00.000Z",
"permissions": ["decisions:read", "decisions:write", "decisions:deploy", "decisions:delete", "executions:read", "agent"],
"origins": ["https://app.example.com"],
"workspace": { "id": "…", "external_id": "acme", "name": "Acme Inc", "created": false, "…": "…" }
}Загрузите url в iframe в течение 60 секунд (он срабатывает один раз) — @dcision/embed делает это за вас.
Ошибки: 400 INVALID_REQUEST (источник вне вашего списка разрешённых, неверный start_path или разрешение), 403 FORBIDDEN (partner_disabled, key_without_author), 404 WORKSPACE_NOT_FOUND.
Отзыв
| Запрос | |
|---|---|
DELETE /v1/embed/sessions/{id} | 204: закрывает одну сессию |
POST /v1/embed/sessions/revoke | { "workspace"?, "user_id"? } → { "revoked": 3 }: закрывает действующие сессии подпространства и/или одного из ваших пользователей |
Закрытая или истёкшая сессия показывает в iframe сообщение «откройте снова из своего приложения»; @dcision/embed открывает новую через ваш бэкенд.
API подпространств
POST, GET, PATCH и DELETE /v1/workspaces — подпространства режима партнёра, по одному на каждого клиента вашего приложения, с адресацией по вашему external_id — и POST /v1/decisions/{slug}/move.
Входящий вебхук
POST /v1/hooks/{token} — запуск опубликованного решения по секретному URL без API-ключа из форм, CRM, Zapier, n8n, Make или любого бэкенда, по желанию с подписью секретом whsec_.