1. Scope
Platformhouder of organisatie
Elke afspraak hoort altijd bij een platformhouder. Optioneel stuur je `organizationId` en `locationId` mee.
API voor ontwikkelaars
Bouw je eigen Dont4get-koppeling voor afspraakaanlevering.
Softwareleveranciers kunnen afspraken aanleveren op platformhouder- of organisatieniveau via de publieke API-specificatie. De afspraak uit het bronsysteem is definitief; een wijziging vanuit de app blijft een voorstel.
2. Beveiliging
API-sleutel per omgeving
Gebruik een bearer API-sleutel met scope `appointments:intake`. Sleutels worden alleen als hash opgeslagen.
3. Aanlevering
Definitieve afspraken
Dont4get registreert de afspraak direct. Bevestiging door de gebruiker is een signaal, geen voorwaarde.
Endpoint
Afspraak aanleveren
POST /api/v1/platform-holders/{platformHolderId}/appointments/intake
Authorization: Bearer <tenant-api-key>
Content-Type: application/json
{
"sourceSystem": "example_ehr",
"externalAppointmentId": "appt_123",
"organizationId": "org_123",
"startsAt": "2026-07-04T09:00:00+02:00",
"endsAt": "2026-07-04T09:30:00+02:00",
"timezone": "Europe/Amsterdam",
"recipient": {
"displayName": "Emma de Vries",
"email": "emma@example.invalid",
"phoneNumberE164": "+31612345678"
}
}Het manifest is aanvullend voor catalogusmetadata zoals naam, logo, scopes en datacategorieën. Log in om tenantinstellingen te beheren.