Endpoint para ver cursos

Este endpoint permite obtener una lista de los cursos disponibles en el sistema.

Método y URL

• Método: GET
• URL: /api/cursos/

Parámetros

Este endpoint no requiere parámetros.

Respuesta

La respuesta será un objeto JSON con los siguientes campos:

• success (boolean): Indica si la operación fue exitosa o no.
• data (array, opcional): Lista de cursos, solo presente si la operación fue exitosa.
  • id (int): ID del curso.
  • id_familia (int): ID de la familia a la que pertenece el curso.
  • nombre (string): Nombre del curso.
  • nombre_oficial (string): Nombre oficial del curso.
  • descripcion (string): Descripción del curso.
  • fecha_insercion (string): Fecha de inserción del registro.
  • fecha_modificacion (string): Fecha de última modificación.
  • usuario_creador (int): ID del usuario que creó el curso.
  • color (string): Color asignado al curso.
  • activo (int): Estado del curso (1 = activo, 0 = inactivo).
  • caducidad (int): Caducidad de la licencia o certificado en días.
  • nivel_curso (int): Nivel del curso.
  • cuando_avisar (int): Número de meses antes de la caducidad para avisar a los alumnos.
  • imagenes (array): Lista de imágenes vinculadas al curso, ordenadas por orden ascendente. Array vacío si el curso no tiene imágenes.
    • id (int): ID de la imagen en la tabla multimedia.
    • url (string): URL absoluta de la imagen a tamaño completo.
    • thumb_url (string): URL absoluta del thumbnail de la imagen.
    • titulo (string|null): Título de la imagen (puede usarse como alt).
    • descripcion (string|null): Descripción de la imagen (puede usarse como caption).
    • orden (int): Orden de la imagen. La imagen con orden = 0 es la principal.
    • tipo (string): Tipo de multimedia (p.ej. imagen).
• message (string, opcional): Mensaje descriptivo del resultado de la operación, solo presente si la operación falló.

Ejemplo de respuesta

{
  "success": true,
  "data": [
    {
      "id": 12,
      "nombre": "Curso de ejemplo",
      "imagenes": [
        {
          "id": 123,
          "url": "https://crm.example.com/e-img/portada.jpg",
          "thumb_url": "https://crm.example.com/e-img/th/portada.jpg",
          "titulo": "Portada",
          "descripcion": null,
          "orden": 0,
          "tipo": "imagen"
        }
      ]
    }
  ]
}