Guía de integración›Empezar›Introducción

Introducción

La API pública de Datrus expone, por HTTP y JSON, lo mismo que la consola: el consentimiento y sus evidencias, las solicitudes de derechos, el inventario y el RAT, los documentos, los proveedores, los incidentes, las evaluaciones de impacto, la capacitación, los reportes, los conectores y la bitácora encadenada. Todo lo que ves en la consola lo puedes leer y, con la llave adecuada, escribir desde tu propio sistema.

Dos idiomas, a propósito. La documentación se lee en español. Las rutas, los campos, los enums, las cabeceras y los códigos de error están en inglés: son el contrato que escribes en tu código, y así lo usan las herramientas que generan clientes.

La base

https://www.datrus.cl/api/v1

Todas las rutas cuelgan de ahí. Las respuestas son application/json; los errores, application/problem+json. Cada respuesta trae una cabecera X-Request-Id que identifica la petición en nuestros registros.

Las secciones

ConsentimientoPlantillas, formularios, solicitudes, acuerdos, evidencias y webhooks. DerechosSolicitudes ARCO+ con su plazo legal y sus procesos. Inventario y RATTratamientos, propuestas desde conectores y cortes del registro. DocumentosPolíticas y avisos con versiones selladas y publicaciones. ProveedoresEncargados, contratos y su expediente. IncidentesBrechas, alcance, decisiones y notificaciones. EIPDEvaluaciones de impacto, riesgos y aprobación. CapacitaciónPadrón, contenidos, difusiones y acuses. BitácoraLa cadena de eventos y su verificación.

Primera llamada

Con una llave creada en la consola (Integraciones › API), pregunta quién eres:

curl https://www.datrus.cl/api/v1/me \
  -H "Authorization: Bearer dtr_live_…"

{
  "company": {
    "id": "cmp_…", "slug": "mi-empresa",
    "legalName": "Mi Empresa SpA", "demoMode": false
  },
  "key": {
    "id": "key_…", "name": "Integración ERP",
    "environment": "live", "permissions": ["*"],
    "expiresAt": "2026-12-13T00:00:00.000Z"
  }
}

Si eso responde, el resto es cuestión de leer la referencia. Antes conviene pasar por autenticación, errores e idempotencia: son las tres cosas que todo cliente tiene que manejar bien.

Siguiente: Autenticación →