Naar hoofdinhoud gaan
Een profiel is een record dat een patiënt of gebruiker in het Aniva-systeem vertegenwoordigt. Elke afspraak, laboratoriumorder en elk resultaat is gekoppeld aan een profiel.

Profielgroepen

Wanneer je een profiel aanmaakt, wijs je het toe aan een profielgroep via de parameter profile_group. Een profielgroep ordent profielen onder je partneraccount en bakent ze af voor een specifiek programma of een specifieke integratie. Het veld profile_group accepteert de onveranderlijke UUID van de groep of de leesbare slug. De UUID is de duurzame referentie — deze verandert nooit en blijft geldig als de slug wordt hernoemd. De slug is bedoeld voor leesbare URL’s en partnerintegraties. Een waarde voor profile_group (UUID of slug) is verplicht bij het aanmaken. Het oudere veld profile_group_slug blijft geaccepteerd als verouderde alias.

Velden

string
vereist
Automatisch door Aniva gegenereerde UUID. Gebruik deze om in andere API-calls naar het profiel te verwijzen.
string
Een optionele gebruikersnaam of handle voor het profiel. Kan null zijn.
string
Voornaam van de patiënt. Alleen Latijnse tekens, 1–100 tekens. Verplicht bij het aanmaken.
string
Achternaam van de patiënt. Alleen Latijnse tekens, 1–100 tekens. Verplicht bij het aanmaken — laboratoria weigeren orders voor een patiënt zonder achternaam. Kan null zijn bij profielen die zijn aangemaakt voordat dit verplicht werd.
string
E-mailadres van de patiënt. Als je er geen opgeeft bij het aanmaken, genereert Aniva automatisch een placeholder-e-mailadres.
string
Telefoonnummer in E.164-formaat (bijv. +14155552671). Kan null zijn.
integer
Biologisch geslacht volgens ISO/IEC 5218: 1 = man, 2 = vrouw. Verplicht bij het aanmaken, tenzij je profielgroep de patiënt dit zelf laat invullen (zie hieronder). Het laboratorium heeft dit nodig voor de referentiebereiken, dus aanmaken of bijwerken met 0 (onbekend) geeft 400 terug. Profielen die vóór 30 september 2026 zijn aangemaakt kunnen nog 0 teruggeven.
string
Geboortedatum in het formaat YYYY-MM-DD. Verplicht bij het aanmaken, tenzij je profielgroep de patiënt dit zelf laat invullen (zie hieronder). Moet in het verleden liggen, niet vóór 1900, en neerkomen op een leeftijd tussen 16 en 100 jaar; onwaarschijnlijke waarden worden geweigerd met 400. De geboortedatum wordt met de order naar het laboratorium gestuurd en kan niet meer worden gewijzigd zodra de order is geplaatst.
number
Lengte in centimeters. Kan null zijn.
number
Gewicht in kilogram. Kan null zijn.
string
Voorkeurstaal voor communicatie richting de patiënt. Geaccepteerde waarden: en, de, fi.
boolean
Of het profiel transactionele e-mails ontvangt, zoals afspraakbevestigingen en meldingen wanneer resultaten klaarstaan. Staat los van marketing-opt-in. Null als dit nooit is ingesteld.
string
vereist
ISO 8601-tijdstempel van het moment waarop het profiel is aangemaakt.
string
ISO 8601-tijdstempel van de meest recente update. Null als het profiel nooit is bijgewerkt.
De velden first_name, last_name, sex, date_of_birth en profile_group zijn verplicht bij het aanmaken van een profiel. Alle andere velden zijn optioneel. Het oudere veld profile_group_slug wordt nog geaccepteerd als verouderde alias voor profile_group.

De patiënt zelf geboortedatum en geslacht laten invullen

We kunnen één instelling voor je profielgroep inschakelen. Dan kun je een profiel aanmaken zonder date_of_birth en sex. Vraag ons om dit in te schakelen. Zonder deze instelling geeft het aanmaken zonder een van beide velden 400 terug. De patiënt vult beide in op de activatiepagina van de kit (anivahealth.com/activate), samen met de kitcode. De pagina vraagt twee keer om de geboortedatum, omdat het laboratorium deze later niet kan wijzigen. Daarna kan de kit alleen met die geboortedatum worden geopend. Totdat de patiënt beide heeft ingevuld, houden we de laboratoriumorder vast. Gebruik deze instelling alleen voor thuistestkits.

Levenscyclus

Profielen volgen een eenvoudige levenscyclus:
  1. Aanmaken — registreer het profiel met de verplichte demografische velden en een profile_group (UUID of slug).
  2. Bijwerken (optioneel) — voeg velden toe of wijzig ze, zoals phone, height of weight.
  3. Koppelen — koppel het profiel aan afspraken met de id ervan als profile_id.
Een profile.*-webhook laat je weten wanneer een profiel verschijnt, verandert of wordt verwijderd.

Voorbeeldprofiel