Endpoint para ver convocatorias

Este endpoint permite obtener una lista de las convocatorias disponibles en el sistema.

Método y URL

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

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 convocatorias, solo presente si la operación fue exitosa.
  • id (int): ID de la convocatoria.
  • id_curso (int): ID del curso asociado.
  • nombre_convocatoria (string): Nombre de la convocatoria.
  • descripcion_convocatoria (string): Descripción de la convocatoria.
  • fecha_insercion (string): Fecha de inserción del registro.
  • fecha_modificacion (string): Fecha de última modificación.
  • fecha_inicio (string): Fecha de inicio de la convocatoria (formato: YYYY-MM-DD).
  • fecha_fin (string): Fecha de fin de la convocatoria (formato: YYYY-MM-DD).
  • usuario_creador (int): ID del usuario que creó la convocatoria.
  • max_alumnos (int): Número máximo de alumnos permitidos.
  • duracion (float): Duración de la convocatoria.
  • color (string): Color asignado a la convocatoria.
  • activo (int): Estado de la convocatoria (1 = activo, 0 = inactivo).
  • aula (int): ID del aula asignada.
  • profesor (int): ID del profesor principal.
  • profesor_2 (int): ID del segundo profesor.
  • profesor_3 (int): ID del tercer profesor.
  • extint (int): Indica si es externo o interno.
  • tipo (int): Tipo de curso (subvencionado, bonificado, particular).
  • modalidad (int): Modalidad (presencial, distancia, mixta).
  • fecha_cerrada (int): Indica si la fecha está cerrada (1 = fecha cerrada, 2 = convocatoria abierta).
  • texto_abierta (string): Texto que se muestra en convocatorias sin fecha cerrada.
  • codigo_entrada (string): Código de entrada a la convocatoria.
  • estado_cerrada (int): Estado de inscripción (0 = abierta, acepta alumnos; 1 = cerrada, no acepta más alumnos).
  • wp_sync (int): Estado de sincronización con WordPress (0 = no, 1 = borrador, 2 = publicado).
  • fecha_de_inscripcion (string): Fecha de inicio de inscripción (formato: YYYY-MM-DD).
  • fecha_limite_inscripcion (string): Fecha límite de inscripción (formato: YYYY-MM-DD).
  • porcentaje_bonificado (float): Porcentaje de bonificación.
  • importe (float): Importe del curso.
  • dirigido_a (string): Público objetivo de la convocatoria.
  • hipervinculo (string): Hipervínculo asociado.
  • cierre_automatico (int): Indica si el cierre es automático (0 = sin activar, 1 = activo).
  • wp_url (string|null): URL del post en WordPress (si está sincronizado).
  • wp_estado (int|null): Estado del post en WordPress.
  • wp_fecha_sync (string|null): Fecha de sincronización con WordPress.
  • wp_id_post (int|null): ID del post en WordPress.
  • imagenes (array): Lista de imágenes vinculadas a la convocatoria, ordenadas por orden ascendente. Array vacío si la convocatoria 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": 45,
      "nombre_convocatoria": "Convocatoria de ejemplo",
      "wp_url": "https://web.example.com/cursos/ejemplo",
      "wp_estado": 2,
      "wp_fecha_sync": "2026-05-12 10:00:00",
      "wp_id_post": 987,
      "imagenes": [
        {
          "id": 456,
          "url": "https://crm.example.com/e-img/foto.jpg",
          "thumb_url": "https://crm.example.com/e-img/th/foto.jpg",
          "titulo": "Foto principal",
          "descripcion": null,
          "orden": 0,
          "tipo": "imagen"
        }
      ]
    }
  ]
}