API v1

Publica tu catálogo SCORM de forma automática

Sube, actualiza y publica contenidos en el marketplace desde tus propios sistemas, o desde Ludificator, con el secret de tu empresa.

Autenticación

URL base https://connectors.cademico.com/api/v1. Envía el secret de tu empresa en cada petición con Authorization: Bearer cxs_… (también vale X-Api-Key). Se genera en Mi panel → API, se muestra una sola vez y al regenerarlo el anterior deja de funcionar. Si tu servidor no tiene mod_rewrite, usa …/api/v1.php/ delante de cada ruta.

Rutas

GET	/me	Comprueba el secret y devuelve tu empresa y saldo.
GET	/contents	Lista tus contenidos.
POST	/contents	Sube un SCORM nuevo (multipart/form-data).
GET	/contents/{id}	Detalle de un contenido.
POST · PATCH	/contents/{id}	Edita campos y/o sustituye el paquete.
POST	/contents/{id}/publish	Publica, o envía a revisión si hay moderación.
POST	/contents/{id}/unpublish	Retira del marketplace.
GET	/contents/{id}/stats	Licencias, compradores e ingresos.

Campos al crear o editar

package: ZIP SCORM 1.2 o 2004. Obligatorio al crear; al editar sustituye la versión que sirven todos los conectores.
title: Si se omite, se toma del manifiesto.
description · category: Texto libre.
language: es, en, ca, eu, gl, pt, fr, de, it.
duration_min: Duración estimada en minutos.
price: Euros por licencia, de 0 a 10.000.
licence_days: De 1 a 3650 (por defecto 180).
cover: Imagen JPG, PNG o WEBP de hasta 5 MB.
publish: 1 publica, 0 retira.

PATCH recibe JSON y no admite archivos; para cambiar el paquete o la portada usa POST con multipart.

Ejemplos

Subir y publicar

curl -X POST https://connectors.cademico.com/api/v1/contents \
  -H "Authorization: Bearer $SECRET" \
  -F package=@excel.zip -F title="Excel avanzado" \
  -F price=10 -F licence_days=180 -F publish=1

Cambiar el precio

curl -X PATCH https://connectors.cademico.com/api/v1/contents/12 \
  -H "Authorization: Bearer $SECRET" \
  -H "Content-Type: application/json" \
  -d '{"price":12.5}'

Nueva versión del paquete

curl -X POST https://connectors.cademico.com/api/v1/contents/12 \
  -H "Authorization: Bearer $SECRET" -F package=@excel-v2.zip

Respuestas

Siempre JSON. Un contenido llega dentro de data con: id, title, description, category, language, duration_min, price, licence_days, status, scorm_version, launch_href, file_size, url, created_at, updated_at.

status: draft, pending, published, rejected o blocked. /stats devuelve licences_total, licences_active, buyers, connectors, earnings_gross, earnings_net y earnings_pending_payout.

Errores

Formato {"error":{"code":422,"message":"…"}}

401	Falta el secret, no es válido o está revocado.
403	Cuenta bloqueada.
404	El contenido no existe o no es tuyo.
405	Ruta o método no soportado.
422	Datos no válidos: ZIP sin imsmanifest.xml, precio fuera de rango, distinta versión SCORM habiendo conectores…
423	Bloqueo de seguridad activo: solo se permiten lecturas (GET).