Ana içeriğe atla
GET
Bir randevunun klinik ve genetik laboratuvar sonuçlarını, laboratuvar raporu PDF’lerinin belge referanslarıyla birlikte getir. Randevu için istenen her biyobelirteç yanıtta yer alır; böylece yalnızca gelenleri değil, tüm siparişi takip edebilirsin. Her sonucun value değerini kullanmadan önce status alanını oku:
  • Randevu in_progress durumundayken henüz sonuçlanmayan testler planned durumuyla görünür.
  • Laboratuvarın ilettiği ancak klinik olarak kullanılmaması gereken sonuçlar fault veya undeliverable durumuyla görünür ve nedenini açıklayan bir status_reason taşır. fault durumundaki bir sonucun value alanı yine de doludur — bu değer yanlıştır. Bunu asla bir bulgu olarak sunma.
  • Aniva’nın veya üyenin şüphe duyduğu sonuçlar likely_wrong durumu ve bir status_reason ile görünür. Değer doğrulanmamıştır. İnceleme olmadan bunu bir bulgu olarak gösterme.
Alınan her sonuç ve belge, kaydedildiği lab_code (tüp barkodu) değerini taşır ve submissions dizisi kan almanın her bir laboratuvar istemini kendi durumuyla listeler — birden fazla tüpü veya laboratuvarı kapsayan bir kan alma, istem istem tamamlanır. documents dizisinde referans verilen laboratuvar raporu PDF’lerini Belgeyi indir ile indir. Bu uç noktayı düzenli olarak sorgulaman gerekmez. appointment.results.updated veya appointment.results.completed webhook’larına abone ol ve bir olay geldiğinde uç noktayı çağır. Yedek yöntem olarak düzenli sorgulama yine de çalışır. results_view kapsamını gerektirir.

İstek

Yol parametreleri

string
gerekli
Sonuçları getirilecek randevunun benzersiz tanımlayıcısı (UUID).

Yanıt

Başarılı olduğunda API, sonuçlar nesnesiyle birlikte 200 OK döndürür.
string
gerekli
Genel sonuç durumu. Şunlardan biri:
  • in_progress — bazı istemler hâlâ laboratuvarda.
  • completed — her istem kapandı ve en az biri rapor verdi.
  • fault — her istem rapor vermeden sonlandı. Beklenen bir şey kalmadı.
object[]
gerekli
Her laboratuvar istemi için bir giriş — birden fazla tüpü veya laboratuvarı kapsayan bir kan almada birden fazla giriş bulunur. Her giriş kapandığında ve biri rapor verdiğinde üst düzey status completed olur.
object[]
gerekli
Klinik biyobelirteç sonuçları dizisi.
object[]
gerekli
Genetik biyobelirteç sonuçları dizisi.
object[]
gerekli
Laboratuvar raporu belgeleri. Her dosyayı indirmek için GET /api/v1/documents/{id} kullan.

Tekrarlanan çağrılar

Aniva bu uç noktanın yanıtını her API anahtarı için 60 dakika boyunca saklar. Bu süre içinde yapılan yinelenen bir çağrı, randevu ve sonuçları değişmediği sürece saklanan yanıtı alır. Bir değişiklikten sonra yeni bir yanıt alırsın. Cache-Status ve Age başlıkları yanıtın saklandığını ve ne kadar eski olduğunu gösterir. Bir değişiklikten hemen haberdar olmak için appointment.results.updated, appointment.results.completed ve appointment.results.fault webhook olaylarına abone ol. Bkz. Yinelenen okumalar.

Hata yanıtları