Saltar al contingut principal
Un perfil és un registre que representa un pacient o usuari al sistema d’Aniva. Cada cita, comanda de laboratori i resultat està associat a un perfil.

Grups de perfils

Quan crees un perfil, l’assignes a un grup de perfils mitjançant el paràmetre profile_group. Un grup de perfils organitza els perfils sota el teu compte de col·laborador i els delimita a un programa o una integració específics. El camp profile_group accepta l’UUID immutable del grup o el seu slug llegible. L’UUID és la referència duradora — no canvia mai i sobreviu als canvis de nom del slug. El slug està pensat per a URL llegibles i integracions de col·laboradors. Cal un valor de profile_group (UUID o slug) en la creació. El camp heretat profile_group_slug continua sent acceptat com a àlies obsolet.

Camps

string
requerit
UUID generat automàticament per Aniva. Fes-lo servir per fer referència al perfil en altres crides a l’API.
string
Un nom d’usuari o identificador opcional per al perfil. Pot ser nul.
string
Nom del pacient. Només caràcters llatins, 1–100 caràcters. Obligatori en la creació.
string
Cognom del pacient. Només caràcters llatins, 1–100 caràcters. Obligatori en la creació — els laboratoris rebutgen comandes d’un pacient sense cognom. Pot ser nul en perfils creats abans que fos obligatori.
string
Adreça electrònica del pacient. Si no en proporciones cap en la creació, Aniva genera automàticament un correu electrònic provisional.
string
Número de telèfon en format E.164 (p. ex., +14155552671). Pot ser nul.
integer
Sexe biològic segons ISO/IEC 5218: 1 = masculí, 2 = femení. Obligatori en la creació, tret que el teu grup de perfils permeti al pacient introduir-lo (consulta més avall). El laboratori el necessita per als intervals de referència, així que una creació o actualització amb 0 (desconegut) retorna 400. Els perfils creats abans del 30 de setembre de 2026 encara poden retornar 0.
string
Data de naixement en format YYYY-MM-DD. Obligatòria en la creació, tret que el teu grup de perfils permeti al pacient introduir-la (consulta més avall). Ha de ser en el passat, no anterior al 1900, i implicar una edat entre 16 i 100 anys; els valors inversemblants es rebutgen amb 400. La data de naixement s’envia al laboratori amb la comanda i no es pot modificar un cop feta la comanda.
number
Alçada en centímetres. Pot ser nul·la.
number
Pes en quilograms. Pot ser nul.
string
Idioma preferit per a les comunicacions adreçades al pacient. Valors acceptats: en, de, fi.
boolean
Indica si el perfil rep correus electrònics transaccionals, com ara confirmacions de cites i avisos de resultats disponibles. Diferent del consentiment de màrqueting. Nul quan no s’ha definit mai.
string
requerit
Marca de temps ISO 8601 de quan es va crear el perfil.
string
Marca de temps ISO 8601 de l’actualització més recent. Nul·la si el perfil no s’ha actualitzat mai.
Els camps first_name, last_name, sex, date_of_birth i profile_group són obligatoris en crear un perfil. Tots els altres camps són opcionals. El camp heretat profile_group_slug continua sent acceptat com a àlies obsolet de profile_group.

Permet que el pacient introdueixi la data de naixement i el sexe

Podem activar una configuració per al teu grup de perfils. Aleshores podràs crear un perfil sense date_of_birth ni sex. Demana’ns que l’activem. Sense aquesta configuració, una creació que ometi qualsevol dels dos camps retorna 400. El pacient introdueix totes dues dades a la pàgina d’activació del kit (anivahealth.com/activate), amb el codi del kit. La pàgina demana la data de naixement dues vegades, perquè el laboratori no la pot modificar més endavant. Després d’això, el kit només s’obre amb aquesta data de naixement. Fins que el pacient no introdueixi totes dues dades, retenim la comanda de laboratori. Fes servir aquesta configuració només per a kits de prova a casa.

Cicle de vida

Els perfils segueixen un cicle de vida senzill:
  1. Crea — registra el perfil amb els camps demogràfics obligatoris i un profile_group (UUID o slug).
  2. Actualitza (opcional) — afegeix o canvia camps com phone, height o weight.
  3. Associa — vincula el perfil a cites fent servir el seu id com a profile_id.
Un webhook profile.* t’avisa quan apareix, canvia o s’elimina un perfil.

Perfil d’exemple