StudySync API - Actividad 01

URL de Producción (Render/Railway): [INSERTE_AQUI_LA_URL]

Descripción

Esta API RESTful, desarrollada con FastAPI, gestiona la entidad Grupos de la plataforma StudySync. Permite coordinar la creación, visualización y administración de grupos de estudio para distintas materias universitarias.

Endpoints Funcionales

1. Listar Grupos (GET)

• Ruta: GET /api/grupos/
• Funcionalidad Estratégica: Soporta paginación (skip, limit) y filtrado (?materia=Matematicas).
• Respuesta Exitosa (200 OK):

  [
    {
      "id": 1,
      "nombre": "Grupo de Cálculo",
      "materia": "Matemáticas",
      "descripcion": "Estudio para el parcial",
      "max_participantes": 10
    }
  ]

2. Obtener Grupo por ID (GET)

• Ruta: GET /api/grupos/{id}
• Respuesta Errónea (404 Not Found):

  { "detail": "Grupo no encontrado" }

3. Crear Grupo (POST)

• Ruta: POST /api/grupos/
• Body de Ejemplo:

  {
    "nombre": "Grupo de Física",
    "materia": "Física I",
    "descripcion": "Repaso de cinemática",
    "max_participantes": 5
  }

• Respuesta Errónea (400 Bad Request - Falta campo):

  {
    "detail": "Faltan campos obligatorios o son inválidos.",
    "errors": ["El campo 'nombre' tiene un error: field required"]
  }

4. Actualizar Grupo (PUT)

• Ruta: PUT /api/grupos/{id}
• Body: Requiere el objeto completo (mismos campos que POST).

5. Eliminar Grupo (DELETE)

• Ruta: DELETE /api/grupos/{id}
• Respuesta Exitosa (200 OK):

  { "message": "Grupo eliminado correctamente" }