API Снегикома

Name: Snegikom
Rating: 4.9 (37 reviews)
Author: Snegikom

Если коротко: создайте ключ в разделе API, выберите подходящий уровень доступа, возьмите готовый пример ниже, подставьте свой домен и ключ — и можно начинать.

Здесь собрано всё, что нужно, чтобы спокойно подключить API Снегикома к вашему сервису, серверу или рабочему сценарию: разовые запросы, запуск сохранённых задач, список устройств и действия, которым нужно подтверждение человека.

Все примеры ниже можно проверить прямо в тестовом режиме API внутри панели управления.

Запуск

LLM + API

Разовые запросы, сценарии и действия в реальном мире через одну поверхность API.

Авторизация

Bearer-ключи

Ключ полного доступа, ключ одной задачи и ключ только для просмотра с понятными границами прав.

Поверхность

Документация + тестовый режим

Сначала смотрите контракт здесь, затем сразу проверяйте тот же запрос в Dashboard → API.

Навигация

Запросы

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

Раздел API Открыть тестовый режим

Важно для интеграции

Authorization: Bearer <API_KEY>

Используйте эту страницу как контракт по API, а тестовый режим в панели — как место для быстрой проверки перед рабочей автоматизацией.

Поверхность продукта

В стиле Dashboard

Эта страница оформлена в том же мягком премиальном стиле карточек, свечений и отступов, что и остальная панель Снегикома.

Таблица запросов

Короткий обзор: какой это запрос, какой ключ нужен и для чего он подходит.

Поиск

Показано: 9

Метод	Путь	Ключ	Права	Для чего нужен
POST	/api/v1/run	Ключ полного доступа	run	Разовый текстовый запрос.
POST	/api/v1/scenarios/:id/run	Ключ одной задачи	scenario:run · run	Запуск одной конкретной задачи из Планировщика.
GET	/api/v1/scenarios/:id/history	Ключ одной задачи или ключ только для просмотра	scenario:history · history	История запусков этой задачи.
GET	/api/v1/devices/list	Ключ полного доступа	devices:read · history · run	Список устройств, которые доступны в текущей рабочей области.
POST	/api/v1/act/proposals	Ключ полного доступа	act:create · run	Создание предложения действия, которое позже можно подтвердить или отклонить.
GET	/api/v1/act/proposals?status=...&since=...&include=commands	Ключ полного доступа	act:read · history	Список предложений действий с фильтрами.
GET	/api/v1/act/proposals/:id?include=commands	Ключ полного доступа	act:read · history	Подробности по одному предложению действия.
POST	/api/v1/act/proposals/:id/approve	Ключ полного доступа	act:approve · run	Подтвердить предложение действия.
POST	/api/v1/act/proposals/:id/reject	Ключ полного доступа	act:approve · run	Отклонить предложение действия.

Примеры

Группы API

Запросы в группе

POST/api/v1/run

Разовый текстовый запрос.

Ключ: Ключ полного доступа•Права: run

Пример запроса

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

Подсказка: Открыть тестовый режим API.

Полезные ссылки

Раздел API

Ключи и тестовый режим

Входящие действия

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

Устройства

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

Примечание: $BASE_URL — это домен, по которому открыт ваш фронтенд, например https://snegikom.ru или http://localhost:3000.