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
- Ve a API Keys en la barra lateral
- Haz clic en Create API Key
- Introduce un nombre descriptivo
- Copia la clave — ¡no se mostrará de nuevo!
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
- Revoca claves en cualquier momento desde la página de API Keys
- 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 en el panel de la nube, por lo que las sesiones de navegador obsoletas pueden necesitar reautenticación antes de que el cambio tenga éxito