Referencia de la API

Referencia de los endpoints, parámetros, modelos y errores de la API de Presente. Cada ruta indica quién puede llamarla y el límite de uso. Las rutas son las mismas que usa la aplicación: no hay una API separada para integraciones, y las rutas internas no tienen garantía de estabilidad. Para los conceptos (autenticación, permisos, paginación, errores), empiece por la guía de integración.

Descargar el OpenAPI (JSON)

• Autenticación — 11. Iniciar, renovar y cerrar sesiones; invitación, primer acceso, cambio y recuperación de contraseña.
• Mi inicio — 4. Vistas de la propia persona: inicio, panel de actividades y estadísticas de asistencia.
• Perfil y sesiones — 11. Perfil de la propia persona, foto, conexiones activas, términos y la encuesta de satisfacción de la aplicación.
• Eliminación de cuenta — 3. Eliminación de la propia cuenta, en la aplicación o por la web.
• Instituciones — 8. Instituciones, política de privacidad y términos de uso de cada una.
• Asignaturas — 4. Asignaturas de una institución.
• Catálogo de actividades — 5. Elementos del catálogo de actividades profesionales de una asignatura, usados para clasificar las actividades.
• Criterios de evaluación — 4. Criterios (y rúbricas) que la asignatura usa para poner notas.
• Grupos — 8. Grupos de una asignatura: alta, período, equipo auxiliar y preparación.
• Matrículas — 3. Alumnos matriculados en un grupo.
• Actividades — 5. Calendario de actividades de un grupo (clases, guardias, prácticas).
• Importación CSV — 3. Importación en lote de personas, alumnos y actividades, con simulación antes de grabar.
• Asistencia (alumno) — 3. Lo que hace el alumno: pedir asistencia, editar el relato y generar el QR de la actividad.
• Asistencia (evaluación) — 7. Lo que hace quien evalúa: cola de pedidos, confirmar o rechazar, lote, lectura de QR y versiones del relato.
• Asistencia del grupo — 1. Matriz de asistencia de un grupo (alumnos × actividades).
• Notas y evaluación — 2. Notas y evaluación de una matrícula, vistas por el equipo o por el propio alumno.
• Autoevaluación final — 2. Autoevaluación final del alumno en un grupo.
• Feedback final — 4. Feedback de cierre que el equipo escribe para cada alumno.
• Evolución — 3. Evolución longitudinal del alumno por asignatura.
• Estadísticas del grupo — 1. Estadísticas de asistencia y notas de un grupo, con exportación.
• Conversación del grupo — 5. Mensajes entre los participantes de un grupo.
• Notificaciones — 5. Avisos de la persona y sus preferencias por tipo.
• Dispositivos — 2. Aparatos que reciben notificaciones push.
• Parámetros — 4. Parámetros de la plataforma y de la institución, con herencia entre niveles.
• Usuarios y vínculos — 8. Personas y roles de una institución: alta, invitación y vínculos.
• Auditoría — 3. Registro de eventos de la institución, con estadísticas y exportación.
• Contacto — 1. Formulario de contacto del sitio, sin inicio de sesión.
• Política de privacidad pública — 1. Página pública de la política de privacidad de una institución, sin inicio de sesión.
• Push en el navegador — 1. Configuración pública para recibir notificaciones push en el navegador.
• Estado del servicio — 1. Verificación simple de que la API está en línea.
• Modelos de datos