API de la plataforma

La API pública de DivisionCero expone los registros de un equipo como REST sobre JSON. Cada endpoint de esta sección incluye su esquema completo, ejemplos de código y un playground para probarlo con tu propia llave.

https://app.divisioncero.com/api/v1

AutenticaciónCopiar enlace

Toda llamada requiere una llave de API del equipo. Créala en la configuración del equipo (Settings → API) y envíala en la cabecera Authorization:

curl https://app.divisioncero.com/api/v1/risks \
  -H "Authorization: Bearer dcero_..."

La llave determina el equipo y qué puede leer o escribir: ningún endpoint recibe el equipo como parámetro. No se aceptan cookies de sesión, por lo que la API puede llamarse desde cualquier origen (CORS abierto).

PermisosCopiar enlace

Al crear la llave eliges sus permisos. Cada endpoint indica en su descripción el permiso que requiere; si la llave no lo tiene, la respuesta es 403.

Paginación y filtrosCopiar enlace

Los endpoints de listado aceptan los mismos parámetros de consulta:

La respuesta envuelve los registros en data e indica si hay más páginas:

{
  "data": [],
  "has_more": true,
  "next_offset": 50
}

Para recorrer todo el listado, repite la llamada con offset=next_offset hasta que has_more sea false.

Crear y actualizar registrosCopiar enlace

Riesgos e incidentes admiten POST (crear, responde 201) y PATCH (actualizar). En un PATCH solo cambian los campos enviados; enviar null limpia un campo opcional.

Los identificadores de catálogo que piden estos registros (categoría, enfoque de tratamiento, fuente de detección, estado…) son propios de cada equipo. Consúltalos antes con GET /risks/catalogs y GET /incidents/catalogs.

Toda escritura queda registrada en la bitácora de auditoría del equipo a nombre de la llave que la hizo.

Límite de solicitudesCopiar enlace

Cada llave puede hacer 300 solicitudes cada 60 segundos. Todas las respuestas incluyen las cabeceras:

• RateLimit-Limit: solicitudes permitidas en la ventana.
• RateLimit-Remaining: solicitudes restantes.
• RateLimit-Reset: segundos hasta que se reinicia la ventana.

Al superar el límite la respuesta es 429 con la cabecera Retry-After.

ErroresCopiar enlace

Los errores responden con un cuerpo JSON con code, status y message:

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "Missing, invalid or expired API key"
}