Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/miagv/PlataformaEduca/llms.txt

Use this file to discover all available pages before exploring further.

All /api/estudiante endpoints require a JWT issued to a user with the ESTUDIANTE role. The platform resolves the student’s identity from the email claim in the JWT — using EstudianteRepository.findByUsuarioEmail() — so each student can only retrieve their own data. Requests from users without the ESTUDIANTE role receive 403 Forbidden.

​
Authentication

​
Authorization
string
required
Bearer token from /api/auth/login. The authenticated user must have the ESTUDIANTE role.
Returns course assignment records available to the student. The response includes Curso, Aula, Docente, and Periodo details for each assignment.
The current implementation returns all AsignacionDocente records (findAll) rather than filtering by student enrollment. This is a known simplification in the source code and may be revised in a future release.

​
curl

curl --request GET \
  --url https://your-api-host/api/estudiante/mis-cursos \
  --header "Authorization: Bearer YOUR_TOKEN"
Returns all Nota records for the authenticated student. The student’s identity is resolved automatically from the JWT email — no student ID is required in the request. Each Nota includes the full Evaluacion object so the student can see the assessment title, weight, date, and course alongside their score and any teacher comment.

​
Response

​
id
integer
Unique identifier for the grade record.
​
nota
number
Numeric score the student received.
​
observacion
string
Teacher comment attached to this grade, if any.
​
evaluacion
object
The evaluation this grade belongs to.
​
estudiante
object
The student record associated with this grade.

​
Example response

[
  {
    "id": 1,
    "nota": 18.5,
    "observacion": "Excelente desempeño",
    "evaluacion": {
      "id": 1,
      "titulo": "Examen Parcial",
      "porcentaje": 30.0,
      "fecha": "2024-06-15"
    }
  }
]

​
curl

curl --request GET \
  --url https://your-api-host/api/estudiante/reporte-notas \
  --header "Authorization: Bearer YOUR_TOKEN"

​
Error responses

StatusCause
401 UnauthorizedThe Authorization header is missing or the token is expired or invalid.
403 ForbiddenThe token is valid but the authenticated user does not have the ESTUDIANTE role.

Build docs developers (and LLMs) love

Get started for freeTalk to us