Ana içeriğe atla
Profil, Aniva sisteminde bir hastayı veya kullanıcıyı temsil eden kayıttır. Her randevu, laboratuvar siparişi ve sonuç bir profille ilişkilendirilir.

Profil grupları

Bir profil oluşturduğunda onu profile_group parametresini kullanarak bir profil grubuna atarsın. Bir profil grubu, iş ortağı hesabının altındaki profilleri düzenler ve bunları belirli bir program veya entegrasyon kapsamına alır. profile_group alanı, grubun değiştirilemez UUID’sini veya insan tarafından okunabilir slug değerini kabul eder. UUID kalıcı referanstır — asla değişmez ve slug yeniden adlandırmalarında da geçerliliğini korur. Slug, okunabilir URL’ler ve iş ortağı entegrasyonları için tasarlanmıştır. Oluşturma sırasında bir profile_group değeri (UUID veya slug) gereklidir. Eski profile_group_slug alanı, kullanımdan kaldırılmış bir takma ad olarak kabul edilmeye devam eder.

Alanlar

string
gerekli
Aniva tarafından otomatik oluşturulan UUID. Diğer API çağrılarında profile başvurmak için bunu kullan.
string
Profil için isteğe bağlı kullanıcı adı veya tanıtıcı. Null olabilir.
string
Hastanın adı. Yalnızca Latin karakterleri, 1–100 karakter. Oluşturma sırasında gereklidir.
string
Hastanın soyadı. Yalnızca Latin karakterleri, 1–100 karakter. Oluşturma sırasında gereklidir — laboratuvarlar soyadı olmayan bir hasta için verilen siparişleri reddeder. Zorunlu hale gelmeden önce oluşturulan profillerde null olabilir.
string
Hastanın e-posta adresi. Oluşturma sırasında bir adres sağlamazsan Aniva otomatik olarak bir yer tutucu e-posta oluşturur.
string
E.164 biçiminde telefon numarası (ör. +14155552671). Null olabilir.
integer
ISO/IEC 5218 standardına göre biyolojik cinsiyet: 1 = erkek, 2 = kadın. Profil grubun hastanın bunu girmesine izin vermiyorsa oluşturma sırasında gereklidir (aşağıya bak). Laboratuvar buna referans aralıkları için ihtiyaç duyar, bu nedenle 0 (bilinmiyor) ile yapılan oluşturma veya güncelleme 400 döndürür. 30 Eylül 2026’dan önce oluşturulan profiller hâlâ 0 döndürebilir.
string
YYYY-MM-DD biçiminde doğum tarihi. Profil grubun hastanın bunu girmesine izin vermiyorsa oluşturma sırasında gereklidir (aşağıya bak). Geçmişte olmalı, 1900’den önce olmamalı ve 16 ile 100 arasında bir yaşa karşılık gelmelidir; gerçekçi olmayan değerler 400 ile reddedilir. Doğum tarihi siparişle birlikte laboratuvara gönderilir ve sipariş verildikten sonra değiştirilemez.
number
Santimetre cinsinden boy. Null olabilir.
number
Kilogram cinsinden kilo. Null olabilir.
string
Hastalara yönelik iletişimlerde tercih edilen dil. Kabul edilen değerler: en, de, fi.
boolean
Profilin randevu onayları ve sonuç hazır bildirimleri gibi işlemsel e-postaları alıp almadığı. Pazarlama onayından ayrıdır. Hiç ayarlanmamışsa null olur.
string
gerekli
Profilin oluşturulduğu zamanın ISO 8601 zaman damgası.
string
En son güncellemenin ISO 8601 zaman damgası. Profil hiç güncellenmediyse null olur.
Profil oluştururken first_name, last_name, sex, date_of_birth ve profile_group alanları gereklidir. Diğer tüm alanlar isteğe bağlıdır. Eski profile_group_slug alanı, profile_group için kullanımdan kaldırılmış bir takma ad olarak kabul edilmeye devam eder.

Hastanın doğum tarihi ve cinsiyeti girmesine izin ver

Profil grubun için bir ayarı açabiliriz. Böylece date_of_birth ve sex olmadan profil oluşturabilirsin. Açmamızı bizden iste. Bu ayar olmadan, iki alandan herhangi birini içermeyen bir oluşturma isteği 400 döndürür. Hasta her ikisini de kit koduyla birlikte kit etkinleştirme sayfasında (anivahealth.com/activate) girer. Sayfa doğum tarihini iki kez sorar, çünkü laboratuvar bunu daha sonra değiştiremez. Bundan sonra kit yalnızca o doğum tarihiyle açılır. Hasta her ikisini de girene kadar laboratuvar siparişini bekletiriz. Bu ayarı yalnızca evde test kitleri için kullan.

Yaşam döngüsü

Profiller basit bir yaşam döngüsü izler:
  1. Oluştur — profili zorunlu demografik alanlar ve bir profile_group (UUID veya slug) ile kaydet.
  2. Güncelle (isteğe bağlı) — phone, height veya weight gibi alanlar ekle ya da değiştir.
  3. İlişkilendir — profilin id değerini profile_id olarak kullanarak profili randevulara bağla.
Bir profile.* webhook’u bir profil oluşturulduğunda, değiştiğinde veya silindiğinde sana haber verir.

Örnek profil