API Снеговика

Если коротко: вы создаёте API‑ключ в разделе «API‑доступ», выбираете подходящий тип (Tenant/Scenario/Read‑only), копируете один из примеров снизу, подставляете свой домен и ключ — и интеграция работает.

Эта страница собрала всё, что нужно, чтобы подключить Snow API к вашим продуктам, бэкендам и no‑code‑сценариям: LLM-запуски, сценарии, а также реальный мир через Act → Помощник (устройства и предложения действий).

Все примеры ниже можно запускать в API Песочнице в дашборде.

Run

LLM + API

One-off calls, scenarios and real-world actions through a single API surface.

Auth

Bearer keys

Tenant, Scenario and Read-only keys with clear scope boundaries and safer integrations.

Surface

Docs + playground

Read the contract here, then validate the same call instantly inside Dashboard → API.

Навигация

Эндпоинты

таблица и примеры

API‑доступ Открыть песочницу

Integration note

Authorization: Bearer <API_KEY>

Use the docs as your contract surface and the dashboard playground as your verification surface before wiring production automations.

Product surface

Closer to dashboard style

This page now mirrors the softer premium cards, glows and spacing rhythm used across the rest of the Snegikom dashboard.

Таблица эндпоинтов

Быстрый обзор: метод, путь, ключ, права доступа и назначение.

Поиск

Показано: 9

Метод	Путь	Ключ	Права	Назначение
POST	/api/v1/run	Ключ Tenant	run	Единичный запуск по текстовой инструкции (LLM).
POST	/api/v1/scenarios/:id/run	Ключ Scenario	scenario:run · run	Запуск конкретного сценария планировщика.
GET	/api/v1/scenarios/:id/history	Ключ Scenario / Read‑only	scenario:history · history	История последних запусков сценария.
GET	/api/v1/devices/list	Ключ Tenant	devices:read · history · run	Список устройств текущего tenant (помощник).
POST	/api/v1/act/proposals	Ключ Tenant	act:create · run	Создание предложения действия (Act).
GET	/api/v1/act/proposals?status=...&since=...&include=commands	Ключ Tenant	act:read · history	Список предложений действий с фильтрами.
GET	/api/v1/act/proposals/:id?include=commands	Ключ Tenant	act:read · history	Детали предложения действия.
POST	/api/v1/act/proposals/:id/approve	Ключ Tenant	act:approve · run	Подтвердить предложение действия.
POST	/api/v1/act/proposals/:id/reject	Ключ Tenant	act:approve · run	Отклонить предложение действия.

Примеры

Группы API

Эндпоинты группы

POST/api/v1/run

Единичный запуск по текстовой инструкции (LLM).

Ключ: Ключ Tenant•Права: run

Example request

curl -X POST $BASE_URL/api/v1/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"prompt":"Собери краткое резюме по задачам за неделю"}'

Подсказка: Открыть API Песочницу.

Ссылки

API‑доступ

Ключи и песочница

Act Inbox

Подтверждение и отклонение предложений

Устройства

Список устройств и настройка помощника

Примечание: $BASE_URL — домен, где доступен фронтенд (например https://snegikom.ru или http://localhost:3000).