Documentación de la API de Drokio

Construí integraciones sobre Drokio: publicá telemetría desde tus sitios, dispará scans bajo demanda, consultá hallazgos de Brain IA, y conectá notificaciones con tus herramientas favoritas.

1. 1

   Obtené tu API key

   Desde el dashboard → Configuración → API Keys. Generá una nueva con permisos de lectura/escritura. El formato es dk_live_… o dk_test_…

2. 2

   Probá la autenticación

   Cualquier endpoint sirve para validar la key — abajo usamos /api/v1/auth/verify que responde con tu plan y uso actual.

3. 3

   Construí tu primer flujo

   Con la key validada, podés empezar a publicar telemetría, consultar eventos o disparar scans desde tu app.

# 1. Verificá tu API key
curl -X POST https://drokio.com/api/v1/auth/verify \
  -H "Authorization: Bearer YOUR_API_KEY"

Todos los endpoints privados requieren el header Authorization: Bearer <api_key>. No usamos OAuth ni JWT — la API key es el único secreto que necesitás manejar. El único endpoint público (sin auth) es GET /api/v1/status.

SDKs con tipado, retries, manejo de rate limits y helpers idiomáticos. Si tu lenguaje no está, usá los snippets de cURL/fetch directamente — la API sigue convenciones REST estándar.

Los límites se aplican por API key, no por IP. Si excedés el límite, la API responde 429 con un header Retry-After indicando los segundos para reintentar.

Los errores siguen el envelope estándar: { success: false, error: { code, message } }. Usá el code (stable) para branching en tu lógica; el message puede cambiar y está pensado para logs humanos.