Vos outils lisent le planning, l'équipe, les heures du mois, les remplacements et les absences de votre box. En lecture seule.
Le gérant crée une clé dans son espace : Importer et connecter, puis API CoverShift. La clé commence par cs_ et n'est affichée qu'une fois. Elle donne accès aux données de sa box seulement. Elle se révoque au même endroit, à tout moment.
curl https://covershift.be/api/v1/planning?from=2026-11-03&to=2026-11-09 \ -H "Authorization: Bearer cs_votre_cle"
Réponse 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" } }
]
}
Les heures sont en UTC. Les dates from et to se lisent à l'heure belge.
| Chemin | Paramètres | Contenu |
|---|---|---|
/api/v1/planning | from, to | Chaque cours : début, fin, intitulé, site, coach, statut : planned (prévu), replacement_open (remplacement demandé, pas encore pris : coach vaut null), replacement (remplacement pris : coach est le remplaçant) ou cancelled (annulé). |
/api/v1/coaches | L'équipe : nom, statut (salarié, indépendant, étudiant, flexi-job, bénévole, via SMart, ou null si la box ne l'a pas précisé), heures de contrat, tarif horaire. | |
/api/v1/hours | month | Les cours donnés du mois (durée, tarif, origine, validation, dimanche ou férié) et, par coach, le mois validé et payé. stale vaut true quand les cours ou le montant ont changé depuis la validation : le mois est alors à revalider. |
/api/v1/replacements | from, to | Les remplacements demandés : cours, statut, coach qui l'a pris. |
/api/v1/absences | from, to | Les congés et absences acceptés des coachs de l'équipe. |
from et to au format AAAA-MM-JJ : par défaut aujourd'hui et quatorze jours plus tard, 92 jours au plus. month au format AAAA-MM : par défaut le mois en cours.
Ni e-mail, ni téléphone, ni NISS, ni IBAN des coachs. Rien ne s'écrit par l'API : le planning se modifie dans CoverShift, ou arrive de Wodify chaque nuit.
| Code | Sens |
|---|---|
| 400 | Date, mois ou période mal écrits (par exemple 2026-1 au lieu de 2026-01). |
| 401 | Clé absente, inconnue ou révoquée. |
| 404 | Ressource inconnue. |
| 429 | Plus de 120 appels dans la minute : attendez un peu. |
Chaque erreur renvoie {"error": "…"} avec la raison en clair. Une question : contact@covershift.be.