Ana içeriğe atla
Kan alma onaylandıktan ve laboratuvar örnekleri işledikten sonra sonuçlar randevu üzerinde erişilebilir olur. Sonuçlar 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üzey status 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. planned durumundaki bir sonuç için null olur.
  • biomarker_name ve category — neyin ölçüldüğü ve grubu (ör. Vitaminler, Hormonlar).
  • lab_code — sonucun kaydedildiği laboratuvar kodu (tüp barkodu), siparişin laboratuvar kodlarından biri. planned durumundaki bir sonuç ve laboratuvarın kod olmadan bildirdiği sonuçlar için null olur.
  • value ve value_operator — geçerli ölçüm. Operatör, tam değerler için eq (eşittir), laboratuvar ölçülebilir aralığın altında veya üstünde bir değer bildirdiğinde ise lt/gt olur.
  • unit — ölçüm birimi (ör. ng/mL, µIU/mL).
  • reference_range_lab — laboratuvarın bu sonuç için bildirdiği, value ile 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ır null olur; bu nedenle < 50 gibi tek taraflı bir aralık normal_min: null, normal_max: 50 olarak 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_lab alanının neden null olduğu. Aralık mevcutsa ve planned durumundaki bir sonuçta null olur. Bkz. Laboratuvar aralığı olmadığında.
  • aniva_range — Aniva’nın derlediği, value ile 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 olarak reference_range_lab değerini kullan. Anahtarın aniva_ranges_view kapsamına sahip olmadığında veya Aniva’nın bu biyobelirteç için değeri bulunmadığında null olur.
  • 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ğinde null olur.
  • status_reason — likely_wrong durumundaki bir sonucun neden şüpheli olduğu veya fault ya da undeliverable durumundaki bir sonucun neden kullanılamaz olduğu. Diğer tüm durumlar için null olur. Laboratuvarın kendi notu olan ve hatalı sonuçlarda genellikle boş kalan comment alanından farklıdır.
  • origin — değerin geldiği belgeyi kimin teslim ettiği; aşağıdaki belge origin değ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. planned durumundaki bir sonuç için null olur.
  • 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.
Değerler genel bilgi amaçlıdır. Tıbbi tavsiye, tanı, tıbbi bulgu veya bir sonucun değerlendirmesi değildir. Aniva bunları tıbbi cihaz olarak sunmaz. Aniva bir sonucu bunlarla karşılaştırmaz ve bunlara göre işaret koymaz. Bir sonuç için standart olarak reference_range_lab ve bir doktorun değerlendirmesi geçerlidir.
Ü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.
Erişim almak için Aniva aralıklarına ilişkin kısa sözleşmeyi imzala. Ardından anahtarına 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ı

Sonuçları hastalara gösterirken doğrudan value alanını kullan — varsa düzeltilmiş değeri zaten yansıtır.
fault durumundaki bir sonucu asla bulgu olarak sunma — value alanı doludur ancak yanlış olduğu doğrulanmıştır.

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. planned durumundaki bir sonuç için null olur.
  • gene — gen sembolü.
  • lab_code — sonucun kaydedildiği laboratuvar kodu (tüp barkodu). planned durumundaki bir sonuç ve laboratuvarın kod olmadan bildirdiği sonuçlar için null olur.
  • 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ğinde null olur.
  • status_reason — likely_wrong durumundaki bir sonucun neden şüpheli olduğu veya fault ya da undeliverable durumundaki bir sonucun neden kullanılamaz olduğu. Diğer tüm durumlar için null olur.
  • 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ç bir variants 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 birinde rs_id, allele, reference_allele ve isteğe bağlı HGVS gösterimi bulunur.

Belgeler

Sonuçlar yanıtındaki documents dizisi, indirilebilir laboratuvar raporu dosyalarına referanslar içerir. Her belgede şunlar bulunur:
  • id — dosya UUID’si. Dosyayı indirmek için bunu GET /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_upload veya partner_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 eklemediyse null.
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 email adresine gider. Yer tutucu bir @aniva.email adresi reddedilir.
  • E-posta, profilin birincil profil grubunun adını ve logosunu gösterir.
  • E-posta profilin language dilindedir, varsayılan olarak İngilizcedir.
  • Laboratuvar raporlarını eklemek için with_reports değerini true olarak ayarla.
  • E-postada en fazla 1.000 karakterlik kişisel bir not göstermek için note ekle.
Profil işlemsel e-postaları kapattıysa çağrı, 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ğinde results_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_emails olmadan 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_view erişimine ihtiyacı vardır. Bu olmadan istek 403 dö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 embed ve results_view kapsamlarına ihtiyacı vardır. embed kapsamı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 veya POST /api/v1/documents ile 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.

Örnek sonuçlar yanıtı