Profil grupları
Bir profil oluşturduğunda onuprofile_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
Aniva tarafından otomatik oluşturulan UUID. Diğer API çağrılarında profile başvurmak için bunu
kullan.
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.
Hastanın e-posta adresi. Oluşturma sırasında bir adres sağlamazsan Aniva otomatik olarak bir yer
tutucu e-posta oluşturur.
E.164 biçiminde telefon numarası (ör.
+14155552671).
Null olabilir.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.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.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.
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öylecedate_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:- Oluştur — profili zorunlu demografik alanlar ve bir
profile_group(UUID veya slug) ile kaydet. - Güncelle (isteğe bağlı) —
phone,heightveyaweightgibi alanlar ekle ya da değiştir. - İlişkilendir — profilin
iddeğeriniprofile_idolarak kullanarak profili randevulara bağla.
profile.* webhook’u bir profil oluşturulduğunda, değiştiğinde veya silindiğinde sana haber verir.