Spring til hovedindhold
En profil er en post, der repræsenterer en patient eller bruger i Aniva-systemet. Hver tid, hver laboratorieordre og hvert resultat er knyttet til en profil.

Profilgrupper

Når du opretter en profil, knytter du den til en profilgruppe med parameteren profile_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

string
påkrævet
UUID, der genereres automatisk af Aniva. Brug denne til at referere til profilen i andre API-kald.
string
Et valgfrit brugernavn eller handle til profilen. Kan være null.
string
Patientens fornavn. Kun latinske tegn, 1–100 tegn. Påkrævet ved oprettelse.
string
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.
string
Patientens e-mailadresse. Hvis du ikke angiver en ved oprettelse, genererer Aniva automatisk en pladsholder-e-mail.
string
Telefonnummer i E.164-format (f.eks. +14155552671). Kan være null.
integer
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.
string
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.
number
Højde i centimeter. Kan være null.
number
Vægt i kilogram. Kan være null.
string
Foretrukket sprog til kommunikation med patienten. Accepterede værdier: en, de, fi.
boolean
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.
string
påkrævet
ISO 8601-tidsstempel for, hvornår profilen blev oprettet.
string
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 uden date_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:
  1. Opret — registrer profilen med de påkrævede demografiske felter og en profile_group (UUID eller slug).
  2. Opdater (valgfrit) — tilføj eller rediger felter som phone, height eller weight.
  3. Tilknyt — knyt profilen til tider ved at bruge dens id som profile_id.
En profile.*-webhook giver dig besked, når en profil oprettes, ændres eller slettes.

Eksempelprofil