API de Snegikom
Playground + docs
API de Snegikom
En resumen: crea una clave en la sección API, elige el nivel de acceso adecuado, toma uno de los ejemplos de abajo, sustituye tu dominio y la clave, y ya puedes empezar.
Aquí está reunido todo lo necesario para conectar la API de Snegikom con tu servicio, tu servidor o tu flujo de trabajo: solicitudes puntuales, tareas guardadas, lista de dispositivos y acciones que pueden requerir aprobación humana.
Todos los ejemplos de abajo se pueden probar directamente en el modo de prueba de API dentro del panel de control.
Run
LLM + API
One-off calls, scenarios and real-world actions through a single API surface.
Auth
Bearer keys
Full-access, single-task, and view-only keys with clear permission boundaries for safer integrations.
Surface
Docs + playground
Read the contract here, then validate the same call instantly inside Dashboard → 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.
v1
Tabla de solicitudes
Una vista rápida de qué es cada solicitud, qué clave necesita y para qué sirve.
Buscar
Mostradas: 9
| Método | Ruta | Clave | Permisos | Para qué sirve |
|---|---|---|---|---|
| POST | /api/v1/run | Clave de acceso completo | run | Una solicitud de texto puntual. |
| POST | /api/v1/scenarios/:id/run | Clave de una sola tarea | scenario:run · run | Inicia una tarea concreta del Programador. |
| GET | /api/v1/scenarios/:id/history | Clave de una sola tarea o clave solo de lectura | scenario:history · history | Historial de esa tarea. |
| GET | /api/v1/devices/list | Clave de acceso completo | devices:read · history · run | Lista de dispositivos disponibles en el espacio de trabajo actual. |
| POST | /api/v1/act/proposals | Clave de acceso completo | act:create · run | Crear una propuesta de acción que luego se puede aprobar o rechazar. |
| GET | /api/v1/act/proposals?status=...&since=...&include=commands | Clave de acceso completo | act:read · history | Listar propuestas de acción con filtros. |
| GET | /api/v1/act/proposals/:id?include=commands | Clave de acceso completo | act:read · history | Detalles de una propuesta de acción. |
| POST | /api/v1/act/proposals/:id/approve | Clave de acceso completo | act:approve · run | Aprobar una propuesta de acción. |
| POST | /api/v1/act/proposals/:id/reject | Clave de acceso completo | act:approve · run | Rechazar una propuesta de acción. |
Ejemplos
Grupos de API
Solicitudes del grupo
POST
/api/v1/runUna solicitud de texto puntual.
Clave: Clave de acceso completo•Permisos: 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":"Haz un resumen semanal breve de tareas"}'Consejo: Abrir modo de prueba de API.
Nota: $BASE_URL es el dominio donde está disponible tu frontend, por ejemplo https://snegikom.ru o http://localhost:3000.
