GET /api/v1/appointments/{id}/results üzerinden alınır ve klinik biyobelirteç sonuçlarını, genetik biyobelirteç sonuçlarını ve indirilebilir laboratuvar raporu belgelerini içerir.
Sonuç durumu
Sonuçlar yanıtındaki en üst düzeystatus alanı genel işleme ilerlemesini gösterir:
Yanıttaki her bir sonucun kendine ait bir durumu vardır (aşağıya bak), bu nedenle genel durum hâlâ
in_progress iken kısmi sonuçları gösterebilirsin.
Sonuçların ne zaman değiştiğini öğrenmek için webhook’lara abone ol. appointment.results.updated sonuçlar gövdesindeki her değişiklikte tetiklenir ve appointment.results.completed en üst düzey durum completed olduğunda tetiklenir. Evde test kiti siparişleri aynı olayları home_kit_order. ön ekiyle gönderir. Her olay, alınacak sonuçlar URL’sini taşır. Doğrulama için bu uç noktayı yine de sorgulayabilirsin.
submissions dizisi en üst düzey durumu her bir laboratuvar talebine göre ayırır. Birden fazla tüpü veya birden fazla laboratuvarı kapsayan bir kan almada birden fazla kayıt bulunur; her biri kaydedildiği lab_code (tüp barkodu) ve kendi in_progress / completed / fault durumuyla gelir. fault durumundaki bir kayıt laboratuvarda reddedilmiş veya iptal edilmiştir ve asla sonuç bildirmez: örnek genellikle başka bir laboratuvara taşınmıştır ve o laboratuvar kendi kaydını açar. Her kayıt kapandığında ve en az biri sonuç bildirdiğinde en üst düzey durum completed olur. Alınan her sonuç ve her belge aynı lab_code değerini taşır, böylece bir değerin hangi tüpten geldiğini anlayabilirsin.
Klinik sonuçlar
Klinik sonuçlar standart kan biyobelirteci ölçümlerini temsil eder — D vitamini düzeyleri, kolesterol, tiroit hormonları ve benzeri. Her klinik sonuç şunları içerir:id— laboratuvar sonucu satır tanımlayıcısı. Laboratuvar bu satırı düzelttiğinde aynı kalır, bu nedenle upsert işlemi için bunu kullan.planneddurumundaki bir sonuç içinnullolur.biomarker_namevecategory— neyin ölçüldüğü ve grubu (ör. Vitaminler, Hormonlar).lab_code— sonucun kaydedildiği laboratuvar kodu (tüp barkodu), siparişin laboratuvar kodlarından biri.planneddurumundaki bir sonuç ve laboratuvarın kod olmadan bildirdiği sonuçlar içinnullolur.valuevevalue_operator— geçerli ölçüm. Operatör, tam değerler içineq(eşittir), laboratuvar ölçülebilir aralığın altında veya üstünde bir değer bildirdiğinde iselt/gtolur.unit— ölçüm birimi (ör. ng/mL, µIU/mL).reference_range_lab— laboratuvarın bu sonuç için bildirdiği,valueile aynı ölçeğe dönüştürülmüş normal ve optimal alt/üst sınırlar. Laboratuvarın açık bıraktığı bir sınırnullolur; bu nedenle< 50gibi tek taraflı bir aralıknormal_min: null, normal_max: 50olarak gelir. Her sonuç, kendisine göre ölçüldüğü aralığı taşır; böylece birden fazla kan alma işleminden veya laboratuvardan sonucu olan bir hasta her sonuç için doğru aralığı görür.reference_range_lab_absent_reason—reference_range_labalanının nedennullolduğu. Aralık mevcutsa veplanneddurumundaki bir sonuçtanullolur. Bkz. Laboratuvar aralığı olmadığında.aniva_range— Aniva’nın derlediği,valueile aynı ölçekteki karşılaştırma değerleri. Yaşa, cinsiyete ve gebelik haftasına göre değişirler.normal_*genel aralıktır.optimal_*daha dar bir aralıktır. Değerler yalnızca bilgi amaçlıdır. Tıbbi tavsiye, tanı veya sonucun değerlendirmesi değildir. Aniva bunlara göre herhangi bir işaret koymaz. Sonuç için standart olarakreference_range_labdeğerini kullan. Anahtarınaniva_ranges_viewkapsamına sahip olmadığında veya Aniva’nın bu biyobelirteç için değeri bulunmadığındanullolur.tested_at— testin yapıldığı tarih.comment— laboratuvarın bu sonuca özel serbest metin notu (ör. referans aralığı açıklaması, örnek kalitesi uyarıları). Laboratuvar bir not eklemediğindenullolur.status_reason—likely_wrongdurumundaki bir sonucun neden şüpheli olduğu veyafaultya daundeliverabledurumundaki bir sonucun neden kullanılamaz olduğu. Diğer tüm durumlar içinnullolur. Laboratuvarın kendi notu olan ve hatalı sonuçlarda genellikle boş kalancommentalanından farklıdır.origin— değerin geldiği belgeyi kimin teslim ettiği; aşağıdaki belgeorigindeğerleriyle aynıdır. Yüklenen bir belgeden (member_upload,staff_upload,partner_upload) gelen bir değer, laboratuvar raporundan değil, Aniva’nın dosyayı okumasından elde edilir: klinik kullanımdan önce dosyayla karşılaştırarak kontrol et.planneddurumundaki bir sonuç içinnullolur.lab_reported— testi yapan laboratuvarın kendi rapor satırı, birebir ve dönüştürülmemiş haliyle. Aşağıya bak.
Aniva aralıkları
aniva_range, Aniva’nın yayımlanmış kaynaklardan ve kendi derlemesinden oluşturduğu
karşılaştırma değerlerini tutar. Aralıklar yaşa, cinsiyete ve gebelik haftasına göre değişir.
sources, Aniva’nın değerler için kaydettiği yayımlanmış kaynakları listeler. Liste boş olabilir.
Ürünün için kurallar:
- Aniva aralığını yalnızca laboratuvarın aralığına ek olarak göster, asla onun yerine koyma.
- Aniva aralığından bir işaret, uyarı veya öneri türetirsen bunu kendi adına ve kendi sorumluluğunla yaparsın.
- Aniva aralığını gösterdiğin her yerde Aniva ile yaptığın sözleşmedeki bildirimi göster.
aniva_ranges_view kapsamını ekleriz. Değerler önceden haber verilmeden değişebilir.
Normalleştirilmiş değerler ve laboratuvarın kendi satırı
value, unit ve reference_range_lab normalleştirilmiştir: aynı analitin farklı laboratuvarlar arasında ve zaman içinde karşılaştırılabilir olması için her ölçümü biyobelirtecin standart birimine dönüştürür ve kendi biyobelirteç adımız altında bildiririz. Eğilimleri izlemek ve laboratuvarlar arasında karşılaştırma yapmak için ihtiyacın olan budur; ancak inceleme yapan bir doktorun laboratuvarın PDF’sinde gördüğü bu değildir — 48 U/l (40 - 129) olarak basılan alkalen fosfataz sana 0.8 µkat/L olarak ulaşır.
lab_reported bu basılı satırı da yanında taşır: laboratuvarın analit adı ve kodu, basıldığı haliyle değer ve birim, hem metin (< 50, > 55, 40 - 129) hem de laboratuvarın kendi dönüştürülmemiş sınırları olarak referans aralığı; ayrıca anormal işareti, sonuç durumu ve notu.
Bir kişi verilerini laboratuvar raporuyla karşılaştırırken lab_reported alanını, hesaplanan her şey içinse standart alanları kullan. Yalnızca laboratuvarın gerçekten gönderdiği alanlar doldurulur; lab_reported içindeki hiçbir şey çıkarımla eklenmez, varsayılan atanmaz veya dönüştürülmez ve bir sonuç için elimizde ham kayıt yoksa nesnenin tamamı null olur.
Laboratuvar aralığı olmadığında
reference_range_lab değeri null olduğunda reference_range_lab_absent_reason bunun nedenini bildirir:
Bazı laboratuvarlar referans aralığı yerine bir hedef veya risk düzeyi basar; örneğin
Ziel: <200. >240 hoch veya <5.7 neg >=6.5 pos. Bunlar reference_range_lab alanına girmez,
bu nedenle sınırları null olur ve nedeni lab_text_only olarak gelir. Basılı metni birebir göster.
< 20 gibi tek taraflı bir aralık yine bir aralıktır. reference_range_lab içinde bir sınırı
null, nedeni ise null olarak gelir. Gösterirken açık tarafı açık bırak.
Klinik sonuç durumları
Genetik sonuçlar
Genetik sonuçlar DNA analizinden elde edilen gen düzeyindeki bulguları temsil eder. Her sonuç bir gene (ör. APOE, MTHFR) karşılık gelir ve şunları içerir:id— laboratuvar sonucu satır tanımlayıcısı. Laboratuvar bu satırı düzelttiğinde aynı kalır, bu nedenle upsert işlemi için bunu kullan.planneddurumundaki bir sonuç içinnullolur.gene— gen sembolü.lab_code— sonucun kaydedildiği laboratuvar kodu (tüp barkodu).planneddurumundaki bir sonuç ve laboratuvarın kod olmadan bildirdiği sonuçlar içinnullolur.genotype— tespit edilen genotip (ör. E3/E4).clinical_significance— bulgunun ACMG tabanlı sınıflandırması.risk_description— genotipin ne anlama geldiğine dair okunabilir açıklama.comment— laboratuvarın bu sonuca özel serbest metin notu. Laboratuvar bir not eklemediğindenullolur.status_reason—likely_wrongdurumundaki bir sonucun neden şüpheli olduğu veyafaultya daundeliverabledurumundaki bir sonucun neden kullanılamaz olduğu. Diğer tüm durumlar içinnullolur.origin— klinik sonuçlarda olduğu gibi, değerin geldiği belgeyi kimin teslim ettiği.variants— her biri SNV düzeyinde ayrıntı içeren, tespit edilen belirli genetik varyantlar.
Klinik anlamlılık değerleri
Genetik sonuç durumları
Varyant yapısı
Her genetik sonuç birvariants dizisi içerir. Her varyant şunları içerir:
name— yaygın ad (ör. APOE E4).clinical_significance— varyant düzeyinde önem (gen düzeyindeki önemden farklı olabilir).conditions— açıklamalarıyla birlikte ilişkili hastalıklar/durumlar.snvs— altta yatan tek nükleotid varyantları; her birinders_id,allele,reference_alleleve isteğe bağlı HGVS gösterimi bulunur.
Belgeler
Sonuçlar yanıtındakidocuments dizisi, indirilebilir laboratuvar raporu dosyalarına referanslar içerir. Her belgede şunlar bulunur:
id— dosya UUID’si. Dosyayı indirmek için bunuGET /api/v1/documents/{id}uç noktasına ilet.file_name— dosya adı; indirme sırasında gönderilen adla aynıdır (ör.20260405 - Quade Befund - 7642001234.pdf).original_file_name— laboratuvarın veya yükleyen kişinin ilettiği haliyle tam dosya adı (ör.7642001234_B0012_FA_E.pdf).origin— dosyayı kimin ilettiği:lab,member_upload,staff_uploadveyapartner_upload(Belge yükle ile sen yükledin).content_type— dosyanın medya türü (ör.application/pdf). Çoğu rapor PDF formatındadır. Yüklenen taramalar görsel veya CSV dosyası olabilir.etag— dosya içeriğinin sürümü; baytlar her değiştiğinde değişir. Bunu sakla ve yalnızca değiştiğinde yeniden indir. S3 veya Google Cloud Storage tarafından kullanılan standart HTTP varlık etiketidir.size_bytes— bayt cinsinden dosya boyutu.lab_code— raporun ait olduğu laboratuvar kodu (tüp barkodu); laboratuvar eklemediysenull.
Belgelere erişim, belgenin sahibi olan profile göre doğrulanır.
Sonuçları müşteriye e-postayla gönderme
Müşteriye sonuçlarının hazır olduğunu e-postayla bildirebilirsin. Bir randevu için Sonuçları e-postayla gönder, bir evde test kiti siparişi için Sonuçları e-postayla gönder uç noktasını çağır. Her çağrı bir e-posta gönderir. Çağrılar tekilleştirilmez.- E-posta, profilin
emailadresine gider. Yer tutucu bir@aniva.emailadresi reddedilir. - E-posta, profilin birincil profil grubunun adını ve logosunu gösterir.
- E-posta profilin
languagedilindedir, varsayılan olarak İngilizcedir. - Laboratuvar raporlarını eklemek için
with_reportsdeğerinitrueolarak ayarla. - E-postada en fazla 1.000 karakterlik kişisel bir not göstermek için
noteekle.
unsubscribed nedeni ile 409 döndürür.
Bunları yeniden açmak için Profili güncelle ile
transactional_emails_enabled değerini true olarak ayarla.
Sonuçlar hazır e-postaları
Bir rezervasyonun sonuçları hazır olduğunda e-posta alabilirsin. Randevu oluştur veya Evde test kiti siparişi oluştur isteğinderesults_ready_emails alanını en fazla 5
adres olarak ayarla. Listeyi daha sonra Randevuyu güncelle veya
Evde test kiti siparişini güncelle ile değiştir; [] e-postaları kapatır.
- Profil grubun için varsayılan e-posta adresleri ayarlamamızı iste.
results_ready_emailsolmadan oluşturulan bir rezervasyon bu adresleri alır. Bir liste vermek o rezervasyon için varsayılanların yerini alır, bu yüzden korumak için varsayılan e-posta adresini listeye ekle.[]hiç e-posta göndermez. - Rezervasyonun her laboratuvar sonucu kesinleştiğinde her adres bir e-posta alır.
- Sonuçlar kesinleştikten sonra eklenen bir adres e-postayı hemen alır.
- E-posta, Aniva yönetim panelindeki sonuç sayfasına bağlantı verir. Müşteri bu e-postayı almaz.
- Anahtarının hasta için
results_viewerişimine ihtiyacı vardır. Bu olmadan istek403döndürür.
Sonuçları uygulamanda göster
Embed oturumu oluştur, salt okunur bir sonuçlar sayfası için tek kullanımlık bir URL döndürür. Hastanın giriş yapmadan sonuçları görmesi için bunu uygulamanın WebView bileşeninde aç.- Anahtarının hasta için
embedveresults_viewkapsamlarına ihtiyacı vardır.embedkapsamını Aniva’dan iste. - Hasta sonuçları her açtığında bunu sunucundan çağır. URL tek seferliktir ve 5 dakika geçerlidir; sayfa bundan sonra 60 dakikalık bir oturum tutar.
route, sunduğumuz sayfalardan birini açar: biyobelirteç listesi, tek bir biyobelirteç veya 3D Twin.appearance, temayı, düğme ve bağlantı renklerini ve logonun görünüp görünmeyeceğini ayarlar.report, sayfayı tek bir randevu, tek bir evde test kiti siparişi veyaPOST /api/v1/documentsile yüklediğin tek bir laboratuvar raporu ile sınırlar. Hasta bu durumda yalnızca o raporun sonuçlarını görür.- Sayfa, bu API gibi yalnızca laboratuvar sonuçlarını gösterir. Dosya, sohbet veya ayar göstermez.