Je tools lezen de planning, het team, de uren van de maand, de vervangingen en de afwezigheden van je box. Alleen lezen.
De beheerder maakt een sleutel aan in zijn ruimte: Importeren en koppelen, dan CoverShift API. De sleutel begint met cs_ en wordt maar één keer getoond. Ze geeft alleen toegang tot de gegevens van zijn box. Ze kan op dezelfde plek op elk moment ingetrokken worden.
curl https://covershift.be/api/v1/planning?from=2026-11-03&to=2026-11-09 \ -H "Authorization: Bearer cs_votre_cle"
Antwoord in 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" } }
]
}
De tijden staan in UTC. De datums from en to volgen de Belgische tijd.
| Pad | Parameters | Inhoud |
|---|---|---|
/api/v1/planning | from, to | Elke les: begin, einde, naam, locatie, coach, status: planned (gepland), replacement_open (vervanging gevraagd, nog niet opgenomen: coach is null), replacement (vervanging opgenomen: coach is de vervanger) of cancelled (geannuleerd). |
/api/v1/coaches | Het team: naam, statuut (werknemer, zelfstandige, student, flexi-job, vrijwilliger, via SMart, of null als de box het niet invulde), contracturen, uurtarief. | |
/api/v1/hours | month | De gegeven lessen van de maand (duur, tarief, herkomst, validatie, zondag of feestdag) en, per coach, de gevalideerde en betaalde maand. stale is true wanneer de lessen of het bedrag gewijzigd zijn sinds de validatie: de maand moet dan opnieuw gevalideerd worden. |
/api/v1/replacements | from, to | De gevraagde vervangingen: les, status, coach die ze opnam. |
/api/v1/absences | from, to | Het aanvaarde verlof en de afwezigheden van de coaches van het team. |
from en to in de vorm JJJJ-MM-DD: standaard vandaag en veertien dagen later, maximaal 92 dagen. month in de vorm JJJJ-MM: standaard de huidige maand.
Geen e-mail, telefoon, rijksregisternummer of IBAN van de coaches. Er wordt niets geschreven via de API: de planning wijzig je in CoverShift, of hij komt elke nacht uit Wodify.
| Code | Betekenis |
|---|---|
| 400 | Datum, maand of periode verkeerd geschreven (bijvoorbeeld 2026-1 in plaats van 2026-01). |
| 401 | Sleutel ontbreekt, is onbekend of ingetrokken. |
| 404 | Onbekende resource. |
| 429 | Meer dan 120 oproepen per minuut: wacht even. |
Elke fout geeft {"error": "…"} terug met de reden in gewone woorden (in het Frans). Een vraag: contact@covershift.be.