API de Edugoverna
Edugoverna es la plataforma de gobernanza de datos personales para colegios chilenos, construida sobre las obligaciones de la Ley 21.719. Esta referencia está escrita para partners: las plataformas que trabajan con colegios y necesitan sincronizar padrones, pedir consentimientos, operar derechos ARCO y recibir eventos, siempre dentro del marco de permisos, alcances y contratos que el colegio controla desde su consola.
La Partner API
Para plataformas externas —sistemas de gestión escolar, agendas, evaluaciones, plataformas de comunicación— que operan sobre los datos de uno o más colegios como encargados de tratamiento. Cada llamada se autoriza contra una conexión (organization_partner_connection) creada por el colegio, respaldada por un contrato de encargo de datos (Art. 15 bis) vigente y acotada por los alcances que el colegio otorgó. Se autentica con Authorization: Bearer y vive bajo:
https://app.edugoverna.com/api/partner/v1/organizations/:organizationId/...
Cinco familias de rutas: padrón, consentimientos, derechos ARCO, actividades de tratamiento y campañas compartidas.
¿Cuál es tu caso?
La diferencia decide qué firma cada parte y por dónde entran los datos. Puedes usar los dos a la vez, un colegio por cada uno.
El colegio tiene cuenta
El padrón es suyo y él decide qué cursos te comparte. Firma el contrato de encargo, otorga los alcances y emite tu credencial. Tú integras por API sobre lo que te compartió. Empieza en Cómo se habilita tu acceso.
El colegio no tiene cuenta
Tú invitas a quien tiene la nómina. Esa persona entra por un portal con código de un solo uso, declara el colegio, carga el curso y firma una declaración jurada versionada — y el padrón queda compartido contigo sin que el colegio se registre. El recorrido está en la guía del registrador externo.
Webhooks salientes
Además de consultar la API, tu plataforma puede recibir eventos: cada organización registra endpoints HTTPS a los que Edugoverna envía notificaciones firmadas (HMAC-SHA256) cuando ocurre algo relevante — por ejemplo consent.decision.recorded cuando un apoderado registra su decisión, o rights_request.created cuando ingresa una solicitud de derechos. Los eventos se filtran por tipo y se entregan con deduplicación por endpoint, y las entregas dirigidas a un partner llevan su propia proyección.
Las convenciones que comparte todo
- Cómo se habilita tu acceso — de la cuenta de partner a la primera llamada.
- Inicio rápido — de la credencial a la primera respuesta.
- Autenticación — credenciales, las cuatro puertas y permisos.
- Paginación — cursores opacos y sincronización incremental con
since. - Errores — el sobre de error y el catálogo de códigos.
- Límites — límites de tasa por credencial y buenas prácticas.
¿Eres un colegio, no un partner?
Si lo que necesitas es automatizar lo tuyo —cargas de datos, reportería, integraciones internas— tu superficie es otra: las API keys de organización, que se autentican con el encabezado x-api-key, identifican por sí solas a la organización y llevan un subconjunto explícito de permisos asignables. Las credenciales no son intercambiables: una API key enviada a una ruta de la Partner API se rechaza con 401 PARTNER_BEARER_REQUIRED, y una credencial de partner no sirve en las rutas de organización.
¿Todavía no tienes cuenta de partner? La abrimos nosotros — conversemos sobre tu integración.