Grups de perfils
Quan crees un perfil, l’assignes a un grup de perfils mitjançant el paràmetreprofile_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
UUID generat automàticament per Aniva. Fes-lo servir per fer referència al perfil en altres
crides a l’API.
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.
Adreça electrònica del pacient. Si no en proporciones cap en la creació, Aniva genera
automàticament un correu electrònic provisional.
Número de telèfon en format E.164 (p. ex.,
+14155552671). Pot ser nul.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.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.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.
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 sensedate_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:- Crea — registra el perfil amb els camps demogràfics obligatoris i un
profile_group(UUID o slug). - Actualitza (opcional) — afegeix o canvia camps com
phone,heightoweight. - Associa — vincula el perfil a cites fent servir el seu
idcom aprofile_id.
profile.* t’avisa quan apareix, canvia o s’elimina un perfil.