Claves de API
Superficie congelada (UI del panel)
La página dedicada de API Keys en el panel de la nube está actualmente congelada por una decisión explícita del producto (2026-07-14, ver docs/FROZEN_SURFACES.md en el repositorio): la entrada de la barra lateral está oculta y /api-keys redirige a /dashboard. El backend de claves de API, las claves existentes y la REST API descritas a continuación permanecen en vivo y retenidas, pero no se planea trabajo nuevo en la UI de API Keys hasta que se levante el congelamiento. Administra las claves de API a través de la superficie de la REST API o contacta con soporte.
Solo en la nube
Las claves de API están disponibles solo en la versión Cloud.
Las claves de API te permiten acceder a la REST API de ADHDev desde servicios externos, scripts o integraciones.
Crear una clave de API
La emisión de claves de API a través del panel no está disponible en la versión actual — consulta el aviso de superficie congelada arriba. Las claves existentes siguen funcionando. Contacta con soporte si necesitas una clave nueva.
Las claves de API llevan el prefijo adk_ para una identificación fácil.
Usar claves de API
Incluye la clave en el encabezado Authorization:
curl -H "Authorization: Bearer adk_your_key_here" \
https://api.adhf.dev/api/v1/daemonsEndpoints disponibles
| Método | Endpoint | Descripción |
|---|---|---|
| GET | /api/v1/daemons | Lista las máquinas conectadas |
| GET | /api/v1/daemons/{daemonId}/status | Lee el snapshot actual de la máquina |
| POST | /api/v1/shortcuts/{daemonId}/launch | Lanza un target de IDE, CLI o ACP |
| POST | /api/v1/shortcuts/{ideId}/chat | Envía un mensaje a un agente |
| POST | /api/v1/shortcuts/{ideId}/approve | Aprueba o rechaza una acción |
| GET | /api/v1/shortcuts/{ideId}/chat | Lee el chat actual |
| GET/POST | /api/v1/shortcuts/{ideId}/chat/debug | Construye un paquete de depuración de chat saneado |
| GET | /api/v1/shortcuts/{ideId}/status | Lee el estado actual del agente |
Consulta la Referencia de la API → completa
Límites de plan
| Plan | Claves de API | Llamadas de API mensuales |
|---|---|---|
| Free | 3 | 1,000 |
| Pro | 10 | 50,000 |
| Ultra | 30 | 500,000 |
| Enterprise | Ilimitado | Ilimitado |
Puedes ver tu uso actual en Account → pestaña Account → Plan limits.
Seguridad
- Las claves se hashean antes de almacenarse — no podemos recuperar tu clave
- La revocación de claves existentes está disponible a través de la REST API; el flujo del panel está pausado junto con la emisión de claves (consulta el aviso de superficie congelada arriba)
- Cada clave puede tener un alcance de permisos específicos
- Las claves de API son para automatización en la nube contra tus propias máquinas y sesiones, no para eludir las comprobaciones de seguridad de la cuenta en cambios de configuración sensibles
- Crear o revocar una clave es una acción protegida por inicio de sesión reciente, por lo que las sesiones de navegador obsoletas pueden necesitar reautenticación antes de que el cambio tenga éxito