APIs de los backends

Esta sección describe las APIs que exponen los dos backends del sistema:

Backend	Sistema	API REST (/api/v1/)	GraphQL
auth-backend	Sistema Único de Identificación (IDP)	Directorio, aprobación de documentos y notificaciones	admin-schema, main-schema, public-schema
backend-seleccion-postulantes	Sistema de Procesos de Selección (SPS)	Interoperabilidad (convocatorias, admitidos, postulaciones)	admin-schema, comision-schema, postulante-schema, estacion-examen-schema

Tipos de API

• REST (/api/v1/): APIs de interoperabilidad para sistemas externos. Están versionadas, protegidas con tokens OAuth2 emitidos por el IDP y documentadas en OpenAPI.
• GraphQL: APIs internas consumidas por las interfaces del propio sistema. No están pensadas para integraciones externas y pueden cambiar sin aviso.

Ruta sugerida de lectura

1. Introducción: URLs base, autenticación y documentación OpenAPI.
2. API REST del IDP.
3. API REST del SPS.
4. APIs GraphQL internas.

TIP

Para obtener tokens (flujos authorization_code + PKCE y client_credentials) consulte la Guía de Integración OAuth2 y OpenID Connect.