Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Miguel-Rodriguez15/msvc/llms.txt

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

Retrieves every course record persisted in the PostgreSQL database backing msvc-cursos. The response is a flat JSON array of Curso objects. Because the usuarios field is marked @Transient, it is not populated here — call GET /{id} to retrieve a single course with its enrolled users resolved from msvc-usuarios. No authentication is required for this endpoint.

Endpoint

GET http://localhost:8002/
Via API Gateway:
GET http://localhost:8090/api/cursos/

Response

200 OK — An array of Curso objects.
[].id
number
Auto-generated primary key of the course.
[].nombre
string
Human-readable name of the course.
[].cursoUsuarios
array
Junction table entries linking enrolled users to this course.
[].cursoUsuarios[].id
number
Auto-generated primary key of the CursoUsuario record in the cursos_usuarios table.
[].cursoUsuarios[].usuarioId
number
The ID of the enrolled user as stored in msvc-usuarios.
[].usuarios
array
Always an empty array in the list response. User details are fetched on demand via GET /\{id\}.

Example

Request

curl http://localhost:8002/

Response — 200 OK

[
  {
    "id": 1,
    "nombre": "Spring Boot 3",
    "cursoUsuarios": [
      { "id": 1, "usuarioId": 3 },
      { "id": 2, "usuarioId": 7 }
    ],
    "usuarios": []
  },
  {
    "id": 2,
    "nombre": "Microservices with Docker",
    "cursoUsuarios": [],
    "usuarios": []
  }
]

The usuarios field is a transient property populated only when the course is fetched individually via GET /\{id\}. The list endpoint returns an empty array for usuarios on every item regardless of enrollment state.

Build docs developers (and LLMs) love