Saltar a contenido

Referencia de endpoints

Referencia endpoint a endpoint de la API de Didacta, extraída del código real (~100 controllers, ~540 endpoints), organizada en cinco áreas:

Cómo leer la referencia

  • Todas las rutas cuelgan de /api/v1 salvo las marcadas con ⚠ (/healthz, /metrics, /api/license, /scim/v2).
  • La columna Auth indica el mínimo necesario: Público (sin sesión, tenant resuelto por dominio), Bearer (cualquier usuario autenticado), formador+/staff, admin (tenant_admin o super_admin), super_admin, ApiKey + scope, o una firma de webhook.
  • Los endpoints Enterprise responden 402 con la capability requerida en el cuerpo; los de un módulo desactivado para el tenant, 403.
  • Los errores de dominio llevan un campo code estable (COURSE_SLUG_EXISTS, SUBSCRIPTIONS_STRIPE_CONFIG_MISSING…) pensado para programar contra él.

El contrato fino, en tu Swagger

Esta referencia cubre rutas, auth, propósito, cuerpos principales y errores. Los schemas exactos de request/response de tu versión desplegada están siempre en el Swagger de tu instancia: https://tu-instancia/api/docs (JSON en /api/docs.json).