Claves de API

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

Abre API en la barra lateral, ponle un nombre a la clave, elige sus permisos y copia la clave — solo se muestra una vez.

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/daemons

Endpoints 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/{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
• Puedes revocar una clave en cualquier momento desde la página API (o mediante la REST API)
• 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