Hopp til hovedinnhold
En profil er en oppføring som representerer en pasient eller bruker i Aniva-systemet. Hver time, laboratoriebestilling og hvert resultat er knyttet til en profil.

Profilgrupper

Når du oppretter en profil, tilordner du den til en profilgruppe ved hjelp av profile_group-parameteren. En profilgruppe organiserer profiler under partnerkontoen din og avgrenser dem til et bestemt program eller en bestemt integrasjon. Feltet profile_group godtar enten gruppens uforanderlige UUID eller dens lesbare slug. UUID-en er den varige referansen – den endres aldri og overlever navneendringer på slug-en. Slug-en er ment for lesbare URL-er og partnerintegrasjoner. En profile_group-verdi (UUID eller slug) er påkrevd ved opprettelse. Det eldre feltet profile_group_slug godtas fortsatt som et utgått alias.

Felter

string
påkrevd
UUID automatisk generert av Aniva. Bruk denne for å referere til profilen i andre API-kall.
string
Et valgfritt brukernavn eller handle for profilen. Kan være null.
string
Pasientens fornavn. Bare latinske tegn, 1–100 tegn. Påkrevd ved opprettelse.
string
Pasientens etternavn. Bare latinske tegn, 1–100 tegn. Påkrevd ved opprettelse – laboratorier avviser bestillinger for en pasient uten etternavn. Kan være null på profiler som ble opprettet før det ble påkrevd.
string
Pasientens e-postadresse. Hvis du ikke oppgir en ved opprettelse, genererer Aniva automatisk en plassholder-e-postadresse.
string
Telefonnummer i E.164-format (f.eks. +14155552671). Kan være null.
integer
Biologisk kjønn etter ISO/IEC 5218: 1 = mann, 2 = kvinne. Påkrevd ved opprettelse, med mindre profilgruppen din lar pasienten oppgi det selv (se nedenfor). Laboratoriet trenger det for referanseområdene, så opprettelse eller oppdatering med 0 (ukjent) returnerer 400. Profiler opprettet før 30. september 2026 kan fortsatt returnere 0.
string
Fødselsdato i YYYY-MM-DD-format. Påkrevd ved opprettelse, med mindre profilgruppen din lar pasienten oppgi den selv (se nedenfor). Må ligge i fortiden, ikke før 1900, og tilsi en alder mellom 16 og 100 år; usannsynlige verdier avvises med 400. Fødselsdatoen sendes til laboratoriet med bestillingen og kan ikke endres etter at bestillingen er lagt inn.
number
Høyde i centimeter. Kan være null.
number
Vekt i kilogram. Kan være null.
string
Foretrukket språk for kommunikasjon med pasienten. Godtatte verdier: en, de, fi.
boolean
Om profilen mottar transaksjons-e-poster, som timebekreftelser og varsler når resultatene er klare. Atskilt fra samtykke til markedsføring. Null hvis den aldri er satt.
string
påkrevd
ISO 8601-tidsstempel for når profilen ble opprettet.
string
ISO 8601-tidsstempel for den siste oppdateringen. Null hvis profilen aldri har blitt oppdatert.
Feltene first_name, last_name, sex, date_of_birth og profile_group er påkrevd når du oppretter en profil. Alle andre felt er valgfrie. Det eldre feltet profile_group_slug godtas fortsatt som et utgått alias for profile_group.

La pasienten oppgi fødselsdato og kjønn

Vi kan slå på én innstilling for profilgruppen din. Da kan du opprette en profil uten date_of_birth og sex. Be oss om å slå den på. Uten den returnerer en opprettelse 400 hvis et av feltene utelates. Pasienten oppgir begge deler på aktiveringssiden for testsettet (anivahealth.com/activate) sammen med koden til testsettet. Siden ber om fødselsdatoen to ganger, fordi laboratoriet ikke kan endre den senere. Etter det åpnes testsettet bare med den fødselsdatoen. Frem til pasienten oppgir begge deler, holder vi tilbake laboratoriebestillingen. Bruk denne innstillingen bare for hjemmetestsett.

Livssyklus

Profiler følger en enkel livssyklus:
  1. Opprett — registrer profilen med obligatoriske demografiske felt og en profile_group (UUID eller slug).
  2. Oppdater (valgfritt) — legg til eller endre felt som phone, height eller weight.
  3. Koble til — knytt profilen til timer ved å bruke dens id som profile_id.
En profile.*-webhook gir deg beskjed når en profil dukker opp, endres eller slettes.

Eksempelprofil