Appointments API

Beheer afspraken met klanten. Maak adviesgesprekken, pasafspraken en afhaalafspraken aan.

GET

/api/vendor/appointments

Geeft afspraken terug, optioneel gefilterd op tijdsperiode.

Vereist scope: appointments:read

bash

curl -s "https://brutlers.com/api/vendor/appointments?from=2026-04-01&to=2026-04-30" \
  -H "X-Api-Key: brut_your_api_key_here"

POST

/api/vendor/appointments

Maakt een nieuwe afspraak aan voor een bestaande klant.

Vereist scope: appointments:write

Request Body

Field	Type		Description
customerId	string	Verplicht veld	ID van de klant (CUID)
type	string	Verplicht veld	Afspraaktype
date	string	Verplicht veld	Datum en tijdstip (ISO 8601)
duration	number	Optioneel	Duur in minuten (15–480, standaard: 60)
notes	string	Optioneel	Notities over de afspraak
orderId	string	Optioneel	Gekoppelde opdracht (optioneel)

Afspraaktype

CONSULTATION — AdviesgesprekFITTING — PassenPICKUP — AfhalenALTERATION — Aanpassing

bash

curl -X POST https://brutlers.com/api/vendor/appointments \
  -H "X-Api-Key: brut_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "clx1234567890abcdef",
    "type": "CONSULTATION",
    "date": "2026-04-15T10:00:00Z",
    "duration": 60,
    "notes": "Erstberatung Brautkleid"
  }'

Statusovergangen

Afspraken doorlopen de volgende statussen:

Voorgesteld→Bevestigd→Afgerond|Geannuleerd

PROPOSED → CONFIRMED, PROPOSED → CANCELLED, CONFIRMED → COMPLETED, CONFIRMED → CANCELLED

PUT

/api/vendor/appointments/:id

Werkt een afspraak bij. Statusovergangen worden gevalideerd.

Vereist scope: appointments:write

DELETE

/api/vendor/appointments/:id

Verwijdert een afspraak. Alleen mogelijk bij status PROPOSED of CANCELLED.

Vereist scope: appointments:write