Este proyecto está orientado al desarrollo e implementación de un sistema de gestión académica diseñado específicamente para la Escuela de Educación Básica Particular Descubrir. Su principal objetivo es facilitar la administración de notas, optimizando el proceso de registro, consulta y seguimiento del desempeño académico de los estudiantes. Además, el sistema busca mejorar la comunicación entre docentes y representantes, proporcionando una plataforma intuitiva y segura para la gestión eficiente de la información escolar.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"37880972","collectionId":"4001e8a3-fa85-4444-bfab-a71250309fcb","publishedId":"2sAYX6o23U","public":true,"customColor":{"top-bar":"3b8842","right-sidebar":"303030","highlight":"2b5bfb"},"publishDate":"2025-07-07T01:38:26.000Z"},"item":[{"name":"Rutas Comunes","item":[{"name":"Recuperar Contraseña","id":"b80a8b85-892f-47a0-a245-adf30d4ddcaf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"email","value":"admintest1@gmail.com","type":"text","id":0}]},"url":"https://escuela-descubrir.vercel.app/api/recuperar-password","description":"Este endpoint es usado para iniciar el proceso de recuperación de la contraseña de usuario.
\nemail (texto): El email del usuario permite el envío de un token como correo.Una vez que se inicia correctamente el proceso de recuperar la contraseña, la respuesta podría tener un status de 200 y un JSON con el mensaje.
\nSe marcará con estado 400 (Bad Request) en los siguientes casos:
\nSe envíen datos vacíos.
\nEl correo es incorrecto o no se encuentra registrado.
\nEste endpoint se utiliza para actualizar la contraseña de un usuario especifico. Esta ruta utiliza un método HTTP Patch.
\nLos datos que se deben enviar como parámetros son los siguientes:
\ntoken : Se verifica el token para restablecer la contraseña por una nueva.Los datos que se deben enviar en la petición son los siguientes:
\npassword (texto): La nueva contraseña de usuario.confirmPassword (texto): La confirmación de la contraseña de usuario, debe ser igual al 'password'.La respuesta de la petición contendrá un mensaje de exito o por el contrario, regresará un error en los siguientes casos:
\nEste endpoint se utiliza para devolver los datos del usuario autenticado. Toma los valores que se han almacenado en el token, para poder buscar en la base de datos y devolver los valores necesarios.
\nAuthorization
\nBearer token : El token de autorización nos permite tomar el id y el rol.
Respuesta
\nSi la petición es correcta, la respuesta regresa un estado 200 OK, con los datos:
\nnombre : Nombre del usuario autenticado.
email : Email del usuario autenticado.
apellido : Apellido del usuario autenticado.
teléfono : Teléfono del usuario autenticado.
dirección : Dirección del usuario autenticado.
En el caso del administrador, no se mostrarán ni la dirección ni el número de teléfono.
\nPor el contrario, si existe un error en la petición se regresará la respuesta con un estado 400 Bad Request, y un mensaje de error, en el siguiente caso:
\nEste endpoint tiene como objetivo cambiar la contraseña de usuario autenticado.
\nAuthorization
\ntoken Bearer: Nos permite tomar el id del usuario autenticado.
Cuerpo de la Petición
\npassword : Contraseña actual del usuario.
newpassword : Nueva contraseña de usuario.
confirmpassword : Confirmación de la nueva contraseña.
Respuesta
\nDependiendo de el ingreso de los datos puede regresar un estado 200 OK con un mensaje. O un mensaje de error con el estado HTTP de 400 Bad Request, con los siguientes casos:
\nHay campos vacíos.
\nLa nueva contraseña y la confirmación son diferentes.
\nLa nueva contraseña tiene menos de 8 caracteres.
\nLa nueva contraseña es igual a la anterior.
\nLa contraseña actual es incorrecta.
\nUsuario no registrado.
\nSin token de autorizacion.
\nEste endpoint tiene como objetivo cambiar los datos del usuario autenticado.
\nAuthorization
\ntoken Bearer: Nos permite tomar el id del usuario autenticado.
Cuerpo de la Petición
\nnombre : Nuevo nombre del usuario.
apellido : Nuevo apellido del usuario.
email : Nuevo email del usuario.
telefono : Nuevo número de teléfono del usuario.
direccion : Nueva dirección del usuario.
Respuesta
\nDependiendo de el ingreso de los datos puede regresar un estado 200 OK con un mensaje. O un mensaje de error con el estado HTTP de 400 Bad Request, con los siguientes casos:
\nEste endpoint tiene como objetivo, devolver todos los años lectivos que se tienen registrados:
\nAuthorization
\ntoken Bearer: Nos permite tomar el id del usuario autenticado.
Respuesta
\nDependiendo de la existencia de los años lectivos puede regresar un estado 200 OK con un objeto. O un mensaje de error con el estado HTTP de 404 Bad Request, con los siguientes casos:
\nEste endpoint tiene como objetivo, confirmar la cuenta después de haber sido creada:
\nAuthorization
\n(No requiere autenticación)
\nParametros de la petición
\n/:token: Este es el token enviado al correo electrónico.
Respuesta
\nDependiendo del token se puede regresar un estado 200 OK con un objeto. O un mensaje de error con el estado HTTP de 404 Bad Request, con los siguientes casos:
\nEsta carpeta almacena y organiza todas las rutas que son compartidas por los diferentes roles de usuarios. Las cuales son para la autenticación y confirmación de la cuenta, recuperación de contraseñas olvidadas, visualización y cambio de datos del perfil.
\nLa mayoría son públicas a excepción de las relacionadas con la visualización y modificación del perfil, estás requieren estar autenticado previamente.
\n","_postman_id":"fb21a4ce-9fdf-4ae0-a068-20666e9f2460"},{"name":"Administrador","item":[{"name":"CRUD Administradores","item":[{"name":"Registro Admin","id":"ca05be48-e1dd-4cd4-89d1-f05e8a561dab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"email","value":"admin123@gmail.com","type":"text","id":0},{"key":"nombre","value":"Lucas","type":"text","id":1},{"key":"apellido","value":"Vasquez","type":"text","id":2},{"key":"direccion","value":"Los Pinos","type":"text","id":3},{"key":"cedula","value":"1783994789","type":"text","id":4},{"key":"telefono","value":"0989026852","type":"text","id":5}]},"url":"https://escuela-descubrir.vercel.app/api/registro","description":"Este endpoint tiene como objetivo registrar a un nuevo administrador.
\nAuthorization
\ntoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Petición
\nnombre : Nuevo nombre del nuevo administrador.
apellido : Nuevo apellido del nuevo administrador.
email : Nuevo email del nuevo administrador.
password : Nueva contraseña del nuevo administrador.
direccion : Nueva dirección del nuevo administrador.
telefono : Nuevo teléfono del nuevo administrador.
Respuesta
\nDependiendo de el ingreso de los datos puede regresar un estado 200 OK con un mensaje. O un mensaje de error con el estado HTTP de 400 Bad Request, con los siguientes casos:
\nEste endpoint tiene como objetivo modificar los datos de un administrador existente.
\nAuthorizationtoken Bearer: Permite identificar al usuario autenticado, verificar sus privilegios y confirmar que tiene rol de administrador.
Cuerpo de la Peticiónid: ID del administrador a modificar.nombre: Nuevo nombre del administrador.apellido: Nuevo apellido del administrador.email: Nuevo email del administrador.direccion: Nueva dirección del administrador.telefono: Nuevo teléfono del administrador.cedula: Nueva cédula del administrador.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Este endpoint tiene como objetivo eliminar (desactivar) un administrador existente.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Peticiónid: ID del administrador a eliminar (en la URL como parámetro).
Respuesta
Dependiendo de la operación puede regresar un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Este endpoint tiene como objetivo listar todos los administradores activos registrados en el sistema.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Petición
(No requiere cuerpo de petición)
Respuesta
Dependiendo de la operación puede regresar un estado 200 OK con la lista de administradores, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Esta carpeta contiene los endpoints que permiten al administrador autenticado poder registrar, listar, modificar y eliminar a otros administradores.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"87a6bfcd-cc79-4047-a341-6cd7617ebf71","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"eba55329-715d-4071-a273-3bde635b4f4b","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"d68272f1-8d78-497d-af07-9b48f69b209c"},{"name":"CRUD Profesor","item":[{"name":"Eliminar Profesor","id":"3a745106-e1ea-4c45-8b04-89bd3107f336","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"https://escuela-descubrir.vercel.app/api/eliminar-profesor/:id","description":"Este endpoint tiene como objetivo eliminar (desactivar) un profesor existente.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Peticiónid: ID del profesor a eliminar (en la URL como parámetro).
Respuesta
Dependiendo de la operación puede regresar un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Este endpoint tiene como objetivo listar todos los profesores activos registrados en el sistema.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Petición
(No requiere cuerpo de petición)
Respuesta
Dependiendo de la operación puede regresar un estado 200 OK con la lista de profesores, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Este endpoint tiene como objetivo modificar los datos de un profesor existente.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Peticiónid: ID del profesor a modificar.nombre: Nuevo nombre del profesor.apellido: Nuevo apellido del profesor.email: Nuevo email del profesor.direccion: Nueva dirección del profesor.telefono: Nuevo teléfono del profesor.cedula: Nueva cédula del profesor.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Este endpoint tiene como objetivo registrar a un nuevo profesor.
\nAuthorization
\ntoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Petición
\nnombre : nombre del nuevo profesor.
apellido : apellido del nuevo profesor.
email : email del nuevo profesor.
direccion : dirección del nuevo profesor.
telefono : teléfono del nuevo profesor.
cedula : cédula de identidad del nuevo profesor.
Respuesta
\nDependiendo de el ingreso de los datos puede regresar un estado 200 OK con un mensaje. O un mensaje de error con el estado HTTP de 400 Bad Request, con los siguientes casos:
\nEsta carpeta contiene los endpoints que permiten al administrador autenticado poder registrar, listar, modificar y eliminar de los profesores.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"ad4d6fed-83c8-4a70-948f-ce256c7cb609","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"798b368b-a9b7-45ef-be14-74ce73c4ab60","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"77814437-2ee7-4570-b3e6-4fa11afc0e15"},{"name":"CRUD Representante","item":[{"name":"Eliminar Representante","id":"81dc4b09-01d2-4446-89f2-98062bcf2636","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"https://escuela-descubrir.vercel.app/api/eliminar-representante/:id","description":"Este endpoint tiene como objetivo eliminar (desactivar) un representante existente.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Peticiónid: ID del representante a eliminar (en la URL como parámetro).
Respuesta
Dependiendo de la operación puede regresar un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
El id no existe o está vacío.
\nEl representante ya está eliminado.
\nEl representante está asociado a estudiantes activos.
\nSin privilegios o rol no administrativo.
\nSin token de autorización.
\nEste endpoint tiene como objetivo listar todos los representantes activos registrados en el sistema, o los asociados a un curso específico.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la PeticióncursoId: ID del curso para filtrar representantes (en la URL como parámetro).
Respuesta
Dependiendo de la operación puede regresar un estado 200 OK con la lista de representantes, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
No hay representantes registrados o activos.
\nEl curso no existe o no tiene estudiantes asociados.
\nSin privilegios o rol no administrativo.
\nSin token de autorización.
\nEste endpoint tiene como objetivo modificar los datos de un representante existente.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Peticiónid: ID del representante a modificar.nombre: Nuevo nombre del representante.apellido: Nuevo apellido del representante.email: Nuevo email del representante.direccion: Nueva dirección del representante.telefono: Nuevo teléfono del representante.cedula: Nueva cédula del representante.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Hay campos vacíos.
\nFormato del email es inválido.
\nEl email ya se encuentra registrado.
\nEl teléfono ya se encuentra registrado.
\nLa cédula ya se encuentra registrada o tiene formato inválido.
\nSin privilegios o rol no administrativo.
\nSin token de autorización.
\nEste endpoint tiene como objetivo registrar a un nuevo profesor.
\nAuthorization
\ntoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Petición
\nnombre : nombre del nuevo profesor.
apellido : apellido del nuevo profesor.
email : email del nuevo profesor.
direccion : dirección del nuevo profesor.
telefono : teléfono del nuevo profesor.
cedula : cédula de identidad del nuevo profesor.
Respuesta
\nDependiendo de el ingreso de los datos puede regresar un estado 200 OK con un mensaje. O un mensaje de error con el estado HTTP de 400 Bad Request, con los siguientes casos:
\nHay campos vacíos.
\nFormato del email es inválido.
\nFormato de la cédula es inválido.
\nFormato del teléfono es inválido.
\nFormato de la contraseña es inválido.
\nEl email ya se encuentra registrado.
\nEl teléfono ya se encuentra registrado.
\nLa cédula ya se encuentra registrada.
\nSin privilegios o rol no administrativo.
\nSin token de autorizacion.
\nEsta carpeta contiene los endpoints que permiten al administrador autenticado poder registrar, listar, modificar y eliminar de los representantes.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"8ea4cb1c-5d22-4bcf-8381-bfe98507a57a","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"8c7d71b6-cc8a-4cb7-9e96-c65a934f0856","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"fbc71ab0-94e6-4577-8db6-16b93d44029a"},{"name":"CRUD Estudiante","item":[{"name":"Eliminar Estudiante","id":"abe3dbb5-fc35-4959-88f6-454744112354","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"https://escuela-descubrir.vercel.app/api/eliminar-estudiante/:id","description":"Este endpoint tiene como objetivo eliminar (desactivar) un estudiante existente.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Peticiónid: ID del estudiante a eliminar (en la URL como parámetro).
Respuesta
Dependiendo de la operación puede regresar un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
El id no existe o está vacío.
\nEl estudiante ya está eliminado.
\nSin privilegios o rol no administrativo.
\nSin token de autorización.
\nEste endpoint tiene como objetivo modificar los datos de un estudiante existente.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Parámetros de la Peticiónid: ID del estudiante a modificar.
Cuerpo de la Petición
nombre: Nuevo nombre del estudiante.apellido: Nuevo apellido del estudiante.cedula: Nueva cédula del estudiante.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Este endpoint tiene como objetivo registrar a un nuevo estudiante en el sistema
\nCuerpo de la Petición
\nnombre: Nombre del nuevo estudiante.
apellido: Apellido del nuevo estudiante.
cedula: Cédula del nuevo estudiante (10 caracteres).
curso: Curso en el que se registrará el estudiante.
cedulaRepresentante:Cédula del representante del estudiante (10 caracteres).
Respuesta
\nDependiendo del ingreso de los datos, la respuesta puede ser un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request. Los posibles casos de error incluyen:
\nEste endpoint tiene como objetivo asignar un representante a un estudiante registrado en el sistema.
\nAuthorization
\ntoken bearer : Nos permite obtener el ID y el rol del usuario autenticado para verificar sus privilegios. Solo los administradores pueden asignar un representante a un estudiante.
Cuerpo de la Petición
\ncedulaEstudiante: Cédula del estudiante al que se asignará el representante (10 caracteres).cedulaRepresentante: Cédula del representante que se asignará al estudiante (10 caracteres).
Respuesta
\nDependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nEste endpoint tiene como objetivo listar todos los estudiantes de un curso.
\nAuthorization
\ntoken bearer : Nos permite obtener el ID y el rol del usuario autenticado para verificar sus privilegios.
Parámetros
\n/:cursoId : Es el nombre del curso del que queremos traer los estudiantes.
Respuesta
\nDependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nEsta carpeta contiene los endpoints que permiten al administrador autenticado poder registrar, listar, modificar y eliminar de los estudiantes.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"205413af-e3fb-43f3-9ae2-98d486344c54","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"b0169d24-460d-462d-af08-e461951cd28c","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"1d39c69b-8d59-4241-881f-ebfe5b1d7689"},{"name":"Gestión de Cursos","item":[{"name":"Crear Curso","id":"f4ec8dde-667f-4fed-ae80-8b9cbd887351","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"nivel","value":"1","type":"text","id":0},{"key":"paralelo","value":"B","type":"text","id":1}]},"url":"https://escuela-descubrir.vercel.app/api/registro-curso","description":"Este endpoint tiene como objetivo crear un nuevo curso.
\nAuthorization
\ntoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Petición
\nnombre : nombre del nuevo curso.
Respuesta
\nDependiendo de el ingreso de los datos puede regresar un estado 200 OK con un mensaje. O un mensaje de error con el estado HTTP de 400 Bad Request, con los siguientes casos:
\nHay campos vacíos.
\nFormato del curso es inválido.
\nEl curso ya se encuentra registrado.
\nSin privilegios o rol no administrativo.
\nSin token de autorizacion.
\nEste endpoint tiene como objetivo listar todos los cursos.
\nAuthorization
\ntoken bearer : Nos permite obtener el ID y el rol del usuario autenticado para verificar sus privilegios.
Respuesta
\nDependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nEste endpoint tiene como objetivo eliminar (desactivar) un curso existente en el año lectivo actual.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Parámetros de la Petición
id: ID del curso a eliminar (en la URL como parámetro).
Cuerpo de la Petición
(No requiere cuerpo de la petición)
Respuesta
Dependiendo de la operación, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
El id no existe o está vacío.
\nEl curso no está asignado en el año lectivo actual.
\nEl curso ya está eliminado.
\nEl curso tiene estudiantes asignados.
\nSin privilegios o rol no administrativo.
\nSin token de autorización.
\nEste endpoint tiene como objetivo reasignar el curso de un estudiante.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Parámetros de la Petición
idCurso: id del curso al cuál se va a asignar al estudiante.
idEstudiante: id del Estudiante que se va a reasignar de curso.
\nCuerpo de la Petición
(No requiere cuerpo de la petición)
Respuesta
Dependiendo de la operación, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
El id del estudiante no existe o está vacío.
\nEl curso no existe.
\nLos ids no son válidos.
\nEsta carpeta contiene los endpoints que permiten al administrador autenticado poder registrar, listar y eliminar cursos.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"a6cf47c1-5cae-4283-b73f-a346219ad71d","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"4b83c85f-f020-44c1-b617-0d9ffc4b97e3","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"a90b4960-9a07-432b-a75f-96314059eaa1"},{"name":"CRUD Materias","item":[{"name":"Crear Materia","id":"45fe69b0-abe4-465b-8d1e-1b68390044d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"nombre","value":"matemáticas","type":"text","id":0},{"key":"curso","value":"68684c029dd2631f6754f179","type":"text","id":1},{"key":"cedulaProfesor","value":"1712345679","type":"text","id":2}]},"url":"https://escuela-descubrir.vercel.app/api/registro-materia","description":"Este endpoint tiene como objetivo registrar a un nueva materia.
\nAuthorization
\ntoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Petición
\nnombre : nombre de la nueva materia.
curso : nombre del curso al que se le asignará la materia.
cedulaProfesor : cédula de identidad del profesor al que se le asignará la materia.
Respuesta
\nDependiendo de el ingreso de los datos puede regresar un estado 200 OK con un mensaje. O un mensaje de error con el estado HTTP de 400 Bad Request, con los siguientes casos:
\nHay campos vacíos.
\nFormato del curso es inválido.
\nEl curso no se encuentra registrado.
\nEl profesor no se encuentra registrado.
\nLa materia ya se encuentra registrado.
\nSin privilegios o rol no administrativo.
\nSin token de autorizacion.
\nEste endpoint tiene como objetivo modificar los datos de una materia existente.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Parámetros de la Peticiónid: ID de la materia a modificar (en la URL como parámetro).
Cuerpo de la Peticiónnombre: Nuevo nombre de la materia.idProfesorNuevo: ID del nuevo profesor asignado a la materia.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
StartFragment
\nEste endpoint tiene como objetivo listar todas las materias activas de un curso específico.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Parámetros de la PeticióncursoId: ID del curso del que se desean listar las materias (en la URL como parámetro).
Cuerpo de la Petición
(No requiere cuerpo de la petición)
Respuesta
Dependiendo de la operación, puede devolver un estado 200 OK con la lista de materias, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
El curso no existe.
\nNo hay materias registradas o activas en el curso.
\nSin privilegios o rol no administrativo.
\nSin token de autorización.
\nEste endpoint tiene como objetivo eliminar (desactivar) una materia existente.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Parámetros de la Petición
id: ID de la materia a eliminar (en la URL como parámetro).
Cuerpo de la Petición
(No requiere cuerpo de la petición)
Respuesta
Dependiendo de la operación, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
El id no existe o está vacío.
\nLa materia ya está eliminada.
\nLa materia no existe.
\nSin privilegios o rol no administrativo.
\nSin token de autorización.
\nEsta carpeta contiene los endpoints que permiten al administrador autenticado poder registrar, listar, modificar materias.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"8bf0c4e2-1078-4504-b87e-2035b36a1e99","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"68e909fc-66bd-43b7-919a-166d9b5fca5d","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"d8dda3c2-cc77-43e9-a6d2-5da8f33a487d"},{"name":"Gestión Asistencias","item":[{"name":"Registro Asistencia","id":"6b229220-1c51-4111-bbea-daffb1ea271c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"curso\": \"68644c860d525256578ea0e0\",\r\n \"asistencias\":{\r\n \"68645e75ad2f73b813ea862e\":\"false\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://escuela-descubrir.vercel.app/api/registro-asistencia","description":"Este endpoint tiene como objetivo registrar la asistencia de los estudiantes de un curso específico.
\nAuthorization
\ntoken bearer : Nos permite obtener el ID y el rol del usuario autenticado para verificar sus privilegios. Solo los administradores pueden registrar la asistencia a un estudiante.
Cuerpo de la Petición
\ncurso: Nombre del curso en el que se registrará la asistencia.asistencias: Objeto donde las claves son los IDs de los estudiantes y los valores pueden ser \"presente\" o \"ausente\".
Respuesta
\nDependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nEl curso no existe o no está asignado al año lectivo.
\nHay estudiantes no registrados en el curso.
\nSin privilegios o rol no administrativo.
\nSin token de autorización.
\nEste endpoint tiene como objetivo registrar una justificación para la inasistencia de un estudiante en una fecha específica.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Peticióncedula: Cédula del estudiante.fecha: Fecha de la inasistencia a justificar.justificacion: Motivo de la justificación.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Esta carpeta agrupa las rutas para registrar y justificar la asistencia de los estudiantes. Permite marcar presentes o ausentes y registrar inasistencias justificadas. Todas las operaciones requieren autenticación y privilegios de administrador.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"b633301b-2b21-47fb-ac04-274bfd8a12eb","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"6bd7a557-1fa7-44f5-9946-e10f626f8c9a","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"e501b3b4-284e-47e0-8fbb-af637a4d6a81"},{"name":"Gestión Años Lectivos","item":[{"name":"Iniciar Año Lectivo","id":"039ab709-20d4-4aab-9274-5e66403c3339","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"method":"POST","header":[],"url":"https://escuela-descubrir.vercel.app/api/iniciar-periodo","description":"Este endpoint tiene como objetivo iniciar un nuevo año lectivo en el sistema.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Petición
\n(No requiere cuerpo de la petición)
\nRespuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Este endpoint tiene como objetivo finalizar el año lectivo activo en el sistema.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Petición
(No requiere cuerpo de la petición)
Respuesta
Dependiendo de la operación, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Este endpoint tiene como objetivo registrar la fecha de finalización del año lectivo activo.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la PeticiónfechaFin: Fecha de finalización del año lectivo.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Este endpoint tiene como objetivo asignar o modificar las ponderaciones de las evaluaciones para el año lectivo activo.
\nAuthorizationtoken Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es administrador.
Cuerpo de la Peticiónponderaciones: Objeto con los valores de ponderación para cada tipo de evaluación (por ejemplo: deberes, talleres, pruebas, exámenes).
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
No hay un año lectivo activo.
\nLas ponderaciones son inválidas o no suman 100%.
\nSin privilegios o rol no administrativo.
\nSin token de autorización.
\nEsta carpeta agrupa todas las rutas para administrar los años lectivos del sistema. Permite iniciar, finalizar, registrar fechas de fin, y asignar ponderaciones a las evaluaciones. Todas las operaciones requieren autenticación y privilegios de administrador.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"44a83b53-6606-4eab-a42d-d0c789a856de","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"88e252ca-b86c-45ff-b76b-53cd067abda8","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"fc2ad5c8-396e-42b9-9301-98c12d917437"},{"name":"Login Administrador","event":[{"listen":"test","script":{"id":"910896d8-41bd-4285-a13a-213a9e449c06","exec":["var data = pm.response.json();\r","pm.globals.set(\"jwt\", data.token);"],"type":"text/javascript","packages":{}}}],"id":"a3553041-6847-4925-b5ab-2c53339da571","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"email","value":"admintest1@gmail.com","type":"text","id":0},{"key":"password","value":"admin123","type":"text","id":1},{"key":"anioLectivo","value":"68684b791e58060006b74532","type":"text","id":2}]},"url":"https://escuela-descubrir.vercel.app/api/login","description":"Este endpoint tiene como objetivo permitir el inicio de sesión de un administrador en el sistema.
\nAuthorization
(No requiere token para la petición inicial de login)
Cuerpo de la Peticiónemail: Email del administrador.password: Contraseña del administrador.anioLectivo: ID del año lectivo en el que desea iniciar sesión.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un token de autenticación y el rol del usuario, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Esta colección agrupa todas las rutas privadas que permiten a los administradores gestionar usuarios, cursos, materias, asignaciones, asistencia, año lectivo y otras entidades del sistema educativo. Incluye operaciones para registrar, modificar, eliminar, listar y asignar roles o recursos, así como la gestión completa del ciclo escolar. Todas las rutas requieren autenticación y permisos de administrador.
\n","_postman_id":"1acdc3c5-dc4a-4d27-9424-058596f709cd"},{"name":"Profesor","item":[{"name":"Notas","item":[{"name":"Subir Notas","id":"eed5c4a6-c2a3-4bba-bf29-cd0aeda21d87","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwtProfe}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"tipo\": \"deberes\",\r\n \"notas\": {\r\n \"68645e75ad2f73b813ea862e\": 8\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://escuela-descubrir.vercel.app/api/registro-nota/:materiaId","description":"Este endpoint tiene como objetivo registrar las notas de los estudiantes para una materia y tipo de evaluación.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es profesor.
Parámetros de la Petición
materiaId: ID de la materia (en la URL como parámetro).
Cuerpo de la Petición
tipo: Tipo de evaluación (deberes, talleres, examenes, pruebas).
notas: Objeto con los IDs de los estudiantes y sus respectivas notas.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito y la descripción de la evaluación, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Hay campos vacíos.
\nEl tipo de evaluación es inválido.
\nLa materia no existe o no está asignada al profesor.
\nEl estudiante no existe.
\nLa nota está fuera del rango permitido.
\nSin privilegios o rol no profesor.
\nSin token de autorización.
\nEste endpoint tiene como objetivo modificar las notas ya registradas de los estudiantes para una materia, tipo de evaluación y descripción específica.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es profesor.
Parámetros de la Petición
materiaId: ID de la materia (en la URL como parámetro).
Cuerpo de la Petición
tipo: Tipo de evaluación (deberes, talleres, examenes, pruebas).
descripcion: Descripción de la evaluación a modificar.
notas: Objeto con los IDs de los estudiantes y sus nuevas notas.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Hay campos vacíos.
\nEl tipo de evaluación o la descripción son inválidos.
\nLa materia no existe o no está asignada al profesor.
\nEl estudiante no existe.
\nLa nota está fuera del rango permitido.
\nSin privilegios o rol no profesor.
\nSin token de autorización.
\nEste endpoint tiene como objetivo listar las notas de los estudiantes de un curso, materia, tipo de evaluación y descripción específica.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es profesor.
Parámetros de la Petición
cursoId: ID del curso (en la URL como parámetro).
materiaId: ID de la materia (en la URL como parámetro).
tipo: Tipo de evaluación (en la URL como parámetro).
Cuerpo de la Petición
descripcion: Descripción de la evaluación a consultar.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con la lista de estudiantes y sus notas, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Hay campos vacíos.
\nEl curso o la materia no existen.
\nEl tipo de evaluación o la descripción son inválidos.
\nSin privilegios o rol no profesor.
\nSin token de autorización.
\nEste endpoint tiene como objetivo subir una imagen como evidencia para una evaluación de los estudiantes de un curso y materia.
\nAuthorization
token Bearer: Nos permite tomar el id y el rol del usuario autenticado, para verificar los privilegios y si es profesor.
Parámetros de la Petición
materiaId: ID de la materia (en la URL como parámetro).
cursoId: ID del curso (en la URL como parámetro).
Cuerpo de la Petición
tipo: Tipo de evaluación (deberes, talleres, examenes, pruebas).
imagen: Archivo de imagen a subir.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un mensaje de éxito y la descripción de la evidencia, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
No se envió ninguna imagen.
\nEl curso o la materia no existen.
\nEl tipo de evaluación es inválido.
\nSin privilegios o rol no profesor.
\nSin token de autorización.
\nEsta carpeta agrupa todas las rutas que permiten a los profesores registrar, actualizar, consultar notas de estudiantes y subir evidencias de evaluaciones. Incluye operaciones para gestionar calificaciones, modificar registros existentes, visualizar notas por tipo y descripción, y asociar imágenes como respaldo de evaluaciones. Todas las rutas requieren autenticación y privilegios de profesor.
\n","_postman_id":"c1a62650-59ac-4e61-b864-97eee5ba6c51","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwtProfe}}"}]},"isInherited":true,"source":{"_postman_id":"6ae584f2-50e8-4388-a64f-b304242e11e2","id":"6ae584f2-50e8-4388-a64f-b304242e11e2","name":"Profesor","type":"folder"}}},{"name":"Listar","item":[{"name":"Listar Estudiantes por Curso","id":"b507d225-72db-4fab-98e9-e7b9b09a26e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwtProfe}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://escuela-descubrir.vercel.app/api/estudiantes/:cursoId","description":"Este endpoint permite a los profesores registrar observaciones a un estudiante.
\ntoken bearer : Se obtiene el ID del usuario autenticado para verificar que sea un profesor y pueda agregar observaciones.
curso: Curso de los estudiantes a listar.
materia: Materia impartida por el profesor.
Dependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nTodos los campos son obligatorios.
\nCurso inválido.
\nCurso no encontrado.
\nEste endpoint permite a los profesores visualizar los curso a los que esta asociado.
\ntoken bearer : Se obtiene el ID del usuario autenticado para verificar que sea un profesor y pueda visualizar sus cursos.
cedula: Cédula del estudiante (10 caracteres).
observacion: Descripción o motivo de la observación asignada.
Dependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nEste endpoint permite a los profesores visualizar los materias a las que esta asociado.
\ntoken bearer : Se obtiene el ID del usuario autenticado para verificar que sea un profesor y pueda visualizar sus materiaa.
/:cursoId: Curso para listar.
Dependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nEste endpoint permite a los profesores visualizar las descripciones de evaluaciones listadas.
\ntoken bearer : Se obtiene el ID del usuario autenticado para verificar que sea un profesor y pueda visualizar sus materiaa.
/:materiaId: Materia para listar.
/:tipo : tipo de actividad (deberes, talleres, pruebas o examenes).
Dependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nTipo de evaluación no válido
\nID de la materia no válido
\nNo hay notas registradas
\nEsta carpeta permite a los profesores listar a las diferentes entidades a su cargo dependiendo del año lectivo seleccionado. El profesor debe estar autenticado para acceder a estas rutas.
\n","_postman_id":"625ff99a-b7c1-4038-8d11-b74c945910ca","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwtProfe}}"}]},"isInherited":true,"source":{"_postman_id":"6ae584f2-50e8-4388-a64f-b304242e11e2","id":"6ae584f2-50e8-4388-a64f-b304242e11e2","name":"Profesor","type":"folder"}}},{"name":"Observaciones","item":[{"name":"Registro Observaciones","id":"91fb89fa-937b-4bfe-998e-cebf77e91380","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwtProfe}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"cedula","value":"1754553206","type":"text","id":0},{"key":"observacion","value":"Mal comportamiento","type":"text","id":1}]},"url":"https://escuela-descubrir.vercel.app/api/observacion-estudiante","description":"Este endpoint permite a los profesores registrar observaciones a un estudiante.
\ntoken bearer : Se obtiene el ID del usuario autenticado para verificar que sea un profesor y pueda agregar observaciones.
cedula: Cédula del estudiante (10 caracteres).
observacion: Descripción o motivo de la observación asignada.
Dependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nTodos los campos son obligatorios.
\nEl estudiante debe estar registrado en la base de datos.
\nEl usuario autenticado debe ser un profesor registrado.
\nEste endpoint tiene como objetivo permitir el inicio de sesión de un profesor en el sistema.
\nAuthorization
(No requiere token para la petición inicial de login)
Cuerpo de la Peticiónemail: Email del profesor.password: Contraseña del profesor.anioLectivo: ID del año lectivo en el que desea iniciar sesión.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un token de autenticación y el rol del usuario, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Hay campos vacíos.
\nEl email no es válido.
\nEl año lectivo no existe.
\nEl email o la contraseña son incorrectos.
\nLa cuenta no está confirmada.
\nLa cuenta está desactivada.
\nEl profesor puede gestionar notas, evidencias, observaciones y consultar toda la información relevante de sus cursos, materias y estudiantes asignados, facilitando así el seguimiento académico y la comunicación con la institución.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwtProfe}}"}]},"isInherited":false},"_postman_id":"6ae584f2-50e8-4388-a64f-b304242e11e2"},{"name":"Representante","item":[{"name":"Login Representante","event":[{"listen":"test","script":{"id":"1292fe76-1e05-4756-ad93-e77660b100ce","exec":["var data = pm.response.json();\r","pm.globals.set(\"jwtRepre\", data.token);"],"type":"text/javascript","packages":{}}}],"id":"6ba7b02b-1280-4234-a3d9-5974ddf99ce0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"email","value":"repreTest1@gmail.com","type":"text","id":0},{"key":"password","value":"Hola1234","type":"text","id":1},{"key":"anioLectivo","value":"68684b791e58060006b74532","type":"text","id":2}]},"url":"https://escuela-descubrir.vercel.app/api/login","description":"Este endpoint tiene como objetivo permitir el inicio de sesión de un representante en el sistema.
\nAuthorization
(No requiere token para la petición inicial de login)
Cuerpo de la Peticiónemail: Email del representante.password: Contraseña del representante.anioLectivo: ID del año lectivo en el que desea iniciar sesión.
Respuesta
Dependiendo de los datos ingresados, puede devolver un estado 200 OK con un token de autenticación y el rol del usuario, o un mensaje de error con el estado HTTP 400 Bad Request en los siguientes casos:
Hay campos vacíos.
\nEl email no es válido.
\nEl año lectivo no existe.
\nEl email o la contraseña son incorrectos.
\nLa cuenta no está confirmada.
\nLa cuenta está desactivada.
\nEste endpoint permite obtener la lista de estudiantes inscritos en una materia específica, incluyendo sus notas registradas en esa materia.
\ntoken bearer : Se obtiene el ID del usuario autenticado para verificar que sea un representante y pueda visualizar sus representados.
Dependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 400 Bad Request en los siguientes casos:
\nEste endpoint permite a un representante consultar las notas de uno de sus estudiantes registrados en el sistema.
\n/:idEstudiante : El id del estudiante al que se quiere visualizar.
token bearer : Se obtiene el ID del usuario autenticado para verificar que sea un representante y pueda visualizar las notas de sus representados.
Dependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 500 Bad Request en los siguientes casos:
\nEste endpoint permite a un representante consultar las observaciones registradas por los profesores sobre uno de sus estudiantes.
\n/:idEstudiante : El id del estudiante al que se quiere visualizar.
token bearer : Se obtiene el ID del usuario autenticado para verificar que sea un representante y pueda visualizar las notas de sus representados.
Dependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 500 Bad Request en los siguientes casos:
\nError.
\nNo se encontraron las observaciones del estudiante.
\nEste endpoint permite a un representante consultar las asistencias registradas por los representantes sobre uno de sus estudiantes.
\n/:idEstudiante : El id del estudiante al que se quiere visualizar.
token bearer : Se obtiene el ID del usuario autenticado para verificar que sea un representante y pueda visualizar las notas de sus representados.
Dependiendo de la validación de los datos, el endpoint puede responder con un estado 200 OK con un mensaje de éxito o con un error 500 Bad Request en los siguientes casos:
\nError.
\nNo se encontraron las observaciones del estudiante.
\nEl representante puede visualizar a sus representados y con esto conocer sus notas, asistencias y observaciones. Manteniendo un mejor control de su rendimiento académico y siendo más participe en su aprendizaje y disciplina escolar.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwtRepre}}"}]},"isInherited":false},"_postman_id":"b0680846-e457-45c0-8bc5-b5f3374629a8"}]}