Referencia de la API

9 endpoints públicos versión v1. Todos los requests autenticados usan Bearer con tu API key en el header Authorization. Límite global: 100 req/min por key.

Resumen

Método	Ruta	Nombre	Auth	Plan mínimo
POST	/api/v1/auth/verify	Verificar API key	Bearer	Starter
POST	/api/v1/telemetry	Enviar telemetría	Bearer	Starter
GET	/api/v1/sites	Listar sitios	Bearer	Starter
GET	/api/v1/sites/{siteId}	Detalle de sitio	Bearer	Starter
GET	/api/v1/events	Listar eventos	Bearer	Starter
POST	/api/v1/scan	Ejecutar scan (legacy)	Bearer	Starter
POST	/api/v1/brain/analyze	Brain IA — análisis	Bearer	Pro+
GET	/api/v1/connect	Integraciones (Connect)	Bearer	Pro+
GET	/api/v1/status	Status del sistema	Público	Starter

Tip: hacé click en una ruta para saltar a la sección correspondiente.

Detalle por endpoint

Verificar API key

#auth-verify

Confirma que la API key es válida, retorna el plan asociado y el uso actual (sitios_allowed / sitios_used). Útil para health-checks de tu integración al arrancar.

Parámetros

Este endpoint no requiere parámetros.

Request de ejemplo

curl -X POST https://drokio.com/api/v1/auth/verify \
  -H "Authorization: Bearer YOUR_API_KEY"

Response de ejemplo

Response

{
  "success": true,
  "data": {
    "valid": true,
    "plan": "pro",
    "sites_allowed": 25,
    "sites_used": 5,
    "expires_at": "2027-01-01T00:00:00Z"
  }
}

Errores posibles

Código	Status	Cuándo ocurre
UNAUTHORIZED	401	El header Authorization falta o no tiene formato Bearer.
INVALID_KEY	401	La API key no existe o fue revocada.
EXPIRED	403	La API key expiró — renovala desde el dashboard.
RATE_LIMITED	429	Excediste el límite de 100 requests/minuto. Incluye header Retry-After.

¿Algo no funciona como esperabas?

La API está en fase beta pública y puede cambiar antes de GA. Si encontrás un bug o inconsistencia con esta referencia, abrí un ticket desde el dashboard o escribinos a soporte@drokio.com.

Ver guías de SDK Volver al inicio