---
title: "Documentación de la API de Edugoverna"
description: "Partner API y API de organización: padrón, consentimientos, derechos ARCO y webhooks firmados, para plataformas que trabajan con colegios."
url: "https://docs.edugoverna.com/"
---
# 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. {{ className: 'lead' }}

<div className="not-prose mt-6 mb-16 flex gap-3">
  <Button href="/gestion/acceso" arrow="right">
    <>Cómo se habilita tu acceso</>
  </Button>
  <Button href="/inicio-rapido" variant="outline">
    <>Inicio rápido</>
  </Button>
</div>

## 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](/padron), [consentimientos](/consentimientos), [derechos ARCO](/derechos-arco), [actividades de tratamiento](/actividades-tratamiento) y [campañas compartidas](/campanas-compartidas).

<div className="not-prose">
  <Button
    href="/autenticacion#credencial-de-partner-api-bearer"
    variant="text"
    arrow="right"
  >
    <>Cómo funciona la credencial de partner</>
  </Button>
</div>

## ¿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](/gestion/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](/guias/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.

<div className="not-prose">
  <Button href="/webhooks" variant="text" arrow="right">
    <>Configura y verifica webhooks</>
  </Button>
</div>

## Las convenciones que comparte todo

- [Cómo se habilita tu acceso](/gestion/acceso) — de la cuenta de partner a la primera llamada.
- [Inicio rápido](/inicio-rapido) — de la credencial a la primera respuesta.
- [Autenticación](/autenticacion) — credenciales, las cuatro puertas y permisos.
- [Paginación](/paginacion) — cursores opacos y sincronización incremental con `since`.
- [Errores](/errores) — el sobre de error y el catálogo de códigos.
- [Límites](/limites) — 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.

<div className="not-prose">
  <Button href="/api-organizacion/introduccion" variant="text" arrow="right">
    <>Explora la API de organización</>
  </Button>
</div>

---

¿Todavía no tienes cuenta de partner? La abrimos nosotros — [conversemos sobre tu integración](https://www.edugoverna.com/partners/contacto).