Zekerboeking API documentatie

Authenticatie

Alle API-aanvragen vereisen een geldige API key in de HTTP header. Je kunt een API-sleutel aanvragen in je dashboard via Instellingen → API aanvragen.

API key in de HTTP Header

Authorization: jouw_api_key

Bij het bereiken van de oproeplimiet (1000 calls) kan de API-sleutel tijdelijk geblokkeerd worden. Houd dit in de gaten en pas je gebruik aan. Dit omdat de api nog in ontwikkeling is.

Nieuwe boeking maken

Maak een nieuwe afspraak voor een event. De aanvraag kan verstuurd worden via application/json of application/x-www-form-urlencoded.

POST /api/event/<uuid>/book

Parameters

• uuid (path) — Unieke ID van het event

Verplichte velden

• first_name — Voornaam van de klant
• email — E-mailadres van de klant
• date — Gewenste datum in YYYY-MM-DD formaat
• time — Gewenste tijd in HH:MM formaat

Optionele velden

• phone — Telefoonnummer van de klant
• message — Extra bericht of opmerking

Voorbeeld request (JSON)

{
  "first_name": "John",
  "email": "johndoe@example.com",
  "date": "2025-05-08",
  "time": "09:00",
  "phone": "0612345678",
  "message": "Extra opmerking"
}

Voorbeeld response

{
    "status": "ok",
    "message": "Boeking succesvol aangemaakt",
    "booking_id": 123
}

Statuscodes

• 201 Created — De boeking is succesvol aangemaakt
• 400 Bad Request — Verplichte velden ontbreken of een ongeldige invoer
• 400 Bad Request — Het opgegeven event is niet actief
• 400 Bad Request — Ongeldig datum- of tijdformaat
• 400 Bad Request — Boeking in het verleden
• 400 Bad Request — Tijdslot niet beschikbaar

Beschikbare slots ophalen

Haal de beschikbare tijdslots op voor een event. Je kunt ofwel een specifieke datum opvragen via de ?date=YYYY-MM-DD parameter, of meerdere dagen ophalen via de ?days=... parameter (standaard 7, maximaal 365 dagen).

GET /api/event/<uuid>/slots?date=2025-05-08

of

GET /api/event/<uuid>/slots?days=14

Parameters

• uuid (path) — Unieke ID van het event
• date (query) — Specifieke datum om op te vragen (YYYY-MM-DD formaat)
• days (query) — Aantal dagen vooruitkijken vanaf vandaag (optioneel, default = 7, max = 365)

Voorbeeld response voor specifieke datum

{
    "status": "ok",
    "available_time_slots": ["09:00", "10:00", "11:00"]
}

Voorbeeld response voor meerdere dagen

{
    "status": "ok",
    "availability": {
        "2025-05-12": ["09:00", "10:00"],
        "2025-05-13": ["13:00"],
        "2025-05-15": ["09:00", "10:00", "11:00", "14:00"]
    }
}

Statuscodes

• 200 OK — Beschikbaarheid succesvol opgehaald
• 400 Bad Request — Ongeldige datum of dagen parameter
• 400 Bad Request — Event is niet actief

Foutmeldingen