Tus herramientas leen el horario, el equipo, las horas del mes, las sustituciones y las ausencias de tu box. Solo lectura.
El gerente crea una clave en su espacio: Importar y conectar, luego API de CoverShift. La clave empieza por cs_ y solo se muestra una vez. Da acceso únicamente a los datos de su box. Se revoca en el mismo sitio, en cualquier momento.
curl https://covershift.be/api/v1/planning?from=2026-11-03&to=2026-11-09 \ -H "Authorization: Bearer cs_votre_cle"
Respuesta en JSON:
{
"gym": "Box Élan",
"data": [
{ "id": "…", "starts_at": "2026-11-03T17:30:00+00:00", "ends_at": "2026-11-03T18:30:00+00:00",
"class": "WOD", "site": null, "status": "planned",
"coach": { "id": "…", "name": "Pauline Martin" } }
]
}
Las horas están en UTC. Las fechas from y to se leen en hora belga.
| Ruta | Parámetros | Contenido |
|---|---|---|
/api/v1/planning | from, to | Cada clase: inicio, fin, nombre, sede, coach, estado: planned (prevista), replacement_open (sustitución solicitada, aún sin coach: coach es null), replacement (sustitución cubierta: coach es el sustituto) o cancelled (cancelada). |
/api/v1/coaches | El equipo: nombre, estatuto (asalariado, autónomo, estudiante, flexi-job, voluntario, vía SMart, o null si el box no lo ha indicado), horas de contrato, tarifa por hora. | |
/api/v1/hours | month | Las clases impartidas del mes (duración, tarifa, origen, validación, domingo o festivo) y, por coach, el mes validado y pagado. stale es true cuando las clases o el importe han cambiado desde la validación: el mes debe validarse de nuevo. |
/api/v1/replacements | from, to | Las sustituciones solicitadas: clase, estado, coach que la cubrió. |
/api/v1/absences | from, to | Las vacaciones y ausencias aceptadas de los coaches del equipo. |
from y to en formato AAAA-MM-DD: por defecto hoy y catorce días después, 92 días como máximo. month en formato AAAA-MM: por defecto el mes en curso.
Ni correo, ni teléfono, ni NISS, ni IBAN de los coaches. Nada se escribe por la API: el horario se modifica en CoverShift, o llega de Wodify cada noche.
| Código | Significado |
|---|---|
| 400 | Fecha, mes o periodo mal escritos (por ejemplo 2026-1 en lugar de 2026-01). |
| 401 | Clave ausente, desconocida o revocada. |
| 404 | Recurso desconocido. |
| 429 | Más de 120 llamadas en un minuto: espera un poco. |
Cada error devuelve {"error": "…"} con el motivo en palabras sencillas (en francés). Una pregunta: contact@covershift.be.