API de Snegikom
Modo de prueba + documentación
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.
Ejecución
LLM + API
Solicitudes puntuales, escenarios y acciones del mundo real a través de una sola superficie API.
Autorización
Claves Bearer
Clave de acceso completo, clave de una sola tarea y clave solo de lectura con límites claros de permisos.
Superficie
Documentación + modo de prueba
Lee aquí el contrato y luego valida al instante la misma llamada dentro de Dashboard → API.
Nota de integración
Authorization: Bearer <API_KEY>
Usa esta página como contrato de la API y el modo de prueba del panel como superficie de verificación rápida antes de conectar automatizaciones de producción.
Superficie del producto
Más cerca del estilo del Dashboard
Esta página sigue el mismo estilo premium suave de tarjetas, brillos y ritmo de espacios que el resto del panel de Snegikom.
v1
Tabla de solicitudes
Una vista rápida de qué es cada solicitud, qué clave necesita y para qué sirve.
Buscar
Mostradas: 7
| 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. |
Ejemplos
Grupos de API
Solicitudes del grupo
POST
/api/v1/runUna solicitud de texto puntual.
Clave: Clave de acceso completo•Permisos: run
Ejemplo de solicitud
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.
