Profielgroepen
Wanneer je een profiel aanmaakt, wijs je het toe aan een profielgroep via de parameterprofile_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
Automatisch door Aniva gegenereerde UUID. Gebruik deze om in andere API-calls naar het profiel te
verwijzen.
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.
E-mailadres van de patiënt. Als je er geen opgeeft bij het aanmaken, genereert Aniva automatisch
een placeholder-e-mailadres.
Telefoonnummer in E.164-formaat (bijv.
+14155552671).
Kan null zijn.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.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.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.
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 zonderdate_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:- Aanmaken — registreer het profiel met de verplichte demografische velden en een
profile_group(UUID of slug). - Bijwerken (optioneel) — voeg velden toe of wijzig ze, zoals
phone,heightofweight. - Koppelen — koppel het profiel aan afspraken met de
idervan alsprofile_id.
profile.*-webhook laat je weten wanneer een profiel verschijnt, verandert of wordt verwijderd.