Integrar

Esta guía es para quien quiere leer o escribir datos de Presente desde otro sistema, por ejemplo un sistema académico: traer alumnos, grupos y actividades, o consultar la asistencia. La API es la misma que usa la aplicación.

Qué existe y qué no existe

• Existe: una API HTTP con cuerpo JSON, descrita en la Referencia de la API y en el archivo OpenAPI.
• Autenticación: inicio de sesión de una persona (correo y contraseña) que devuelve un token de acceso de corta duración y un token de renovación. Vea Autenticación.
• No existe: clave de API de larga duración, webhooks (Presente no avisa a su sistema; usted consulta), portal de registro de desarrolladores ni un entorno de pruebas separado del de demostración.
• Quién puede qué depende del rol de la cuenta que usa: vea Permisos. Solo puede leer y modificar lo que esa cuenta ya podría hacer en la aplicación.

Direcciones

Entorno	Base de la API	Para qué
Producción	https://app.presente.app.br/api	Datos reales de su institución.
Demostración	https://demo.presente.app.br/api	Datos ficticios, restaurados cada domingo de madrugada (lo que usted modifique allí no permanece). Útil para probar el código.

Los ejemplos usan $API para la base y $TOKEN para el token de acceso:

export API=https://demo.presente.app.br/api

Las llamadas hechas directamente desde un navegador, desde otro sitio, no están habilitadas (CORS). Integre desde un servidor suyo.

Por dónde empezar

1. Autenticación: obtener y renovar el token.
2. Permisos: qué rol necesita la cuenta de integración.
3. Errores y Paginación y límites: cómo responde la API cuando algo falla y cómo listar muchos elementos.
4. Los recorridos, paso a paso: alumnos, grupos y actividades.

Estabilidad

Las rutas descritas aquí son las que usa la aplicación. Son internas y no tienen garantía de estabilidad: pueden agregarse campos, y una ruta puede cambiar cuando cambie la aplicación. Agregar campos a la respuesta no se trata como un cambio incompatible, así que ignore los campos que no conozca. Si su integración necesita una garantía mayor, escriba a contato@presente.app.br.

El archivo OpenAPI y esta referencia se generan a partir del código de la API; por eso reflejan la versión publicada.

Datos de ejemplo

Todos los ejemplos usan datos ficticios (personas, correos e identificadores inventados). Nunca ponga datos personales reales en pruebas en la demostración.