Profilgrupper
Når du opretter en profil, knytter du den til en profilgruppe med parameterenprofile_group. En profilgruppe organiserer profiler under din partnerkonto og afgrænser dem til et bestemt program eller en bestemt integration.
Feltet profile_group accepterer enten gruppens uforanderlige UUID eller dens læsbare slug. UUID’en er den varige reference — den ændrer sig aldrig og overlever omdøbning af slug. En slug er beregnet til læsbare URL’er og partnerintegrationer.
En værdi for profile_group (UUID eller slug) er påkrævet ved oprettelse. Det ældre felt profile_group_slug accepteres stadig som et forældet alias.
Felter
UUID, der genereres automatisk af Aniva. Brug denne til at referere til profilen i andre API-kald.
Patientens efternavn. Kun latinske tegn, 1–100 tegn. Påkrævet ved oprettelse — laboratorier
afviser ordrer til en patient uden efternavn. Kan være null på profiler, der blev oprettet, før
det blev påkrævet.
Patientens e-mailadresse. Hvis du ikke angiver en ved oprettelse, genererer Aniva automatisk en
pladsholder-e-mail.
Telefonnummer i E.164-format (f.eks.
+14155552671).
Kan være null.Biologisk køn efter ISO/IEC 5218:
1 = mand, 2 =
kvinde. Påkrævet ved oprettelse, medmindre din profilgruppe lader patienten selv indtaste det (se
nedenfor). Laboratoriet skal bruge det til referenceintervallerne, så oprettelse eller opdatering
med 0 (ukendt) returnerer 400. Profiler oprettet før 30. september 2026 kan stadig returnere
0.Fødselsdato i formatet
YYYY-MM-DD. Påkrævet ved oprettelse, medmindre din profilgruppe lader
patienten selv indtaste den (se nedenfor). Skal ligge i fortiden, ikke før 1900, og svare til en
alder mellem 16 og 100 år; usandsynlige værdier afvises med 400. Fødselsdatoen sendes til
laboratoriet sammen med ordren og kan ikke ændres, når ordren først er afgivet.Om profilen modtager transaktionelle e-mails, såsom bekræftelser på tider og beskeder om, at
resultater er klar. Adskilt fra samtykke til markedsføring. Null, hvis den aldrig er angivet.
ISO 8601-tidsstempel for den seneste opdatering. Null, hvis profilen aldrig er blevet opdateret.
Felterne
first_name, last_name, sex, date_of_birth og profile_group er påkrævede ved
oprettelse af en profil. Alle andre felter er valgfrie. Det ældre felt profile_group_slug
accepteres stadig som et forældet alias for profile_group.Lad patienten indtaste fødselsdato og køn
Vi kan slå en indstilling til for din profilgruppe. Så kan du oprette en profil udendate_of_birth og sex. Bed os om at slå den til. Uden den returnerer oprettelsen 400, hvis et
af felterne udelades.
Patienten indtaster begge dele på siden til kitaktivering (anivahealth.com/activate) sammen med
kitkoden. Siden beder om fødselsdatoen to gange, fordi laboratoriet ikke kan ændre den senere.
Derefter kan kittet kun åbnes med den fødselsdato. Indtil patienten indtaster begge dele,
tilbageholder vi laboratorieordren. Brug kun denne indstilling til hjemmetestkits.
Livscyklus
Profiler følger en enkel livscyklus:- Opret — registrer profilen med de påkrævede demografiske felter og en
profile_group(UUID eller slug). - Opdater (valgfrit) — tilføj eller rediger felter som
phone,heightellerweight. - Tilknyt — knyt profilen til tider ved at bruge dens
idsomprofile_id.
profile.*-webhook giver dig besked, når en profil oprettes, ændres eller slettes.