Naar hoofdinhoud gaan
Met deze handleiding vind je een testlocatie, maak je een afspraak aan voor een patiëntprofiel en koppel je de uit te voeren testpanels. Voltooi deze stappen voordat de patiënt voor de bloedafname komt.
1

Beschikbare locaties bekijken

Haal de lijst met testlocaties op die beschikbaar zijn op je account met een GET-verzoek naar /api/v1/locations.
De response is een array met locatieobjecten:
Gebruik het veld timezone uit het locatieobject wanneer je het tijdstip voor scheduled_at samenstelt. Door de afspraaktijd om te rekenen naar de lokale tijdzone van de locatie voorkom je dat je buiten de openingstijden plant.
Leid boekbare tijden niet alleen af uit open_hours. Roep Beschikbaarheid ophalen aan en boek een starttijd die daaruit terugkomt — dat rooster houdt ook rekening met bestaande boekingen, uitzonderingen per datum en de minimale boekingstermijn.
2

De afspraak aanmaken

Stuur een POST-verzoek naar /api/v1/appointments met de profiel-ID, locatie-ID en de gewenste afspraaktijd. De tijd moet een starttijd zijn uit Beschikbaarheid ophalen.
scheduled_at moet een toekomstige datum en tijd in ISO 8601-formaat zijn, bijvoorbeeld 2026-05-12T07:30:00Z. Tijdstippen in het verleden worden geweigerd met een 400-fout, net als tijden binnen de minimale boekingstermijn van 12 uur op locaties die door Aniva worden beheerd.
Dit verzoek herhalen is veilig. Een profiel kan maar één afspraak per locatie en tijdstip hebben, dus een opnieuw of dubbel verstuurd aanmaakverzoek geeft 409 terug met de bestaande appointment_id in plaats van de patiënt twee keer te boeken.
Een geslaagd verzoek geeft 201 Created terug met het afspraakobject:
Bewaar de id van de afspraak — je hebt deze nodig om panels toe te voegen en de bloedafname te bevestigen.
3

Testpanels toevoegen

Koppel de testpanels die je op het bloedmonster wilt laten uitvoeren met een POST-verzoek naar /api/v1/appointments/{id}/panels.Panel-ID’s zijn UUID’s. Roep Panels ophalen aan om de panels te zien die je API-sleutel kan bestellen.
Panels kunnen niet meer worden toegevoegd nadat de bloedafname is bevestigd. Voeg alle benodigde panels vóór de bevestiging toe — zie Bloedafname bevestigen voor details.
Een geslaagd verzoek geeft 200 OK terug als bevestiging dat de panels zijn toegevoegd:

Verzetten of annuleren

Nadat je een afspraak hebt aangemaakt, kun je deze nog aanpassen voordat de bloedafname is bevestigd:
  • Verzetten of locatie wijzigen — Stuur een PATCH-verzoek naar /api/v1/appointments/{id} met de velden die je wilt bijwerken. Zie Afspraak bijwerken.
  • Annuleren — Stuur een DELETE-verzoek naar /api/v1/appointments/{id}. Zie Afspraak annuleren.
Beide bewerkingen zijn alleen beschikbaar vóór de bloedafname — dus zolang de afspraak de status pending of confirmed heeft. Zodra de afspraak op blood_drawn staat, zijn er geen wijzigingen meer mogelijk.

Foutafhandeling