Tokens de la API de integración
La API de integración conecta los sistemas de su organización (RH, ERP, BI) con Eduvem: registro y matrícula automáticos, extracción de informes, descarga de certificados y más. Todo acceso se realiza mediante tokens creados por el administrador.
Creando y gestionando tokens
Sección titulada «Creando y gestionando tokens»- Cree varios tokens nombrados e independientes - uno por sistema integrado es la buena práctica. Cada uno puede revocarse sin afectar a los demás.
- El valor del token se muestra una única vez, al crearlo. Guárdelo en la bóveda de secretos de su organización: si se pierde, el camino es eliminar el token y crear otro.
- Algunos datos exigen permiso adicional otorgado en el token: descarga de certificados, el historial de auditoría de matrículas y los informes. Otorgue solo lo que la integración realmente usa.
Qué hace la integración
Sección titulada «Qué hace la integración»Registro y actualización de participantes (individual y por lote), gestión de grupos y roles, matrículas y cambios de estado (aprobar, rechazar, cancelar, reactivar), listado y descarga de certificados en PDF, informes (resumen por sala y exportación por matrícula), catálogo de salas y contenidos, y el ranking.
En la matrícula vía API, el participante puede identificarse por correo electrónico o CPF - si aún no existe, el registro se crea automáticamente.
Auditoría
Sección titulada «Auditoría»Toda llamada realizada por la API queda registrada por la plataforma (qué, cuándo y con qué token). Ese registro no se muestra en el panel administrativo: si necesita saber qué hizo un sistema externo, solicite la consulta al soporte de Eduvem indicando el token y el período.
Límites de uso
Sección titulada «Límites de uso»- El tráfico está limitado por institución (presupuesto estándar de 1.000 solicitudes por minuto, ajustable a pedido).
- Las operaciones pesadas (exportaciones de auditoría/informes y descarga de certificados) tienen un presupuesto propio, menor - un pico en ellas no bloquea el resto de la integración.
- Los listados están paginados (100 elementos por página de forma predeterminada, máximo 1.000): oriente a los integradores a paginar siempre.
- El listado de certificados tiene un límite menor: máximo 100 elementos por página (una página mayor es rechazada).