Ana içeriğe atla
GET
Gömülü hasta profili dahil olmak üzere tek bir kan alma randevusunu UUID’sine göre getir. Randevu durumunu kontrol etmek, planlama ayrıntılarını doğrulamak veya ilişkili profil verilerini almak için bu uç noktayı kullan. appointments_view veya appointments_schedule kapsamını gerektirir.

İstek

Yol parametreleri

string
gerekli
Getirilecek randevunun benzersiz tanımlayıcısı (UUID).

Yanıt

Başarılı olduğunda API, randevu ve gömülü profiliyle birlikte 200 OK döndürür.
string
gerekli
Benzersiz randevu tanımlayıcısı (UUID).
string
gerekli
Bu randevunun ait olduğu profilin UUID’si.
string
Kan almanın gerçekleştiği test konumunun UUID’si.
string
UTC anı olarak planlanan randevu tarih ve saati (Z son ekli ISO 8601, ör. 2026-05-15T10:30:00Z). null olabilir.
string
gerekli
Mevcut randevu durumu. pending, confirmed, blood_drawn veya cancelled değerlerinden biri. Laboratuvar sonuçlarının tamamlanma ayrıntıları Sonuçları getir üzerinden; daha ayrıntılı gönderi ilerleyişi ise satır içi shipments dizisindeki (aşağıya bak) her kaydın Gönderiyi getir ile takip edilmesiyle elde edilir.
string
Randevu iptal edildiğinde kaydedilen serbest metin neden (ör. gelmeme, geç iptal, ‘Başarısız. Tekrar gerekli’). status değeri cancelled değilse null olur.
string[]
gerekli
Tüm laboratuvar sonuçları kesinleştiğinde her birine bir e-posta gönderilen, küçük harfe çevrilmiş adresler. Kapalıyken boştur. Bkz. Sonuçlar hazır e-postaları.
string
gerekli
Kan alma yöntemi: capillary (parmak ucundan veya üst koldan, mikrotüplere) ya da venous (damardan, tüplere). Randevuda belirlenen yöntemdir; belirlenmemişse konumun default_draw_method değeridir. Kan almadan sonra kullanılan yöntemdir.
string
gerekli
Randevunun oluşturulduğu zamanın ISO 8601 zaman damgası.
string
Son güncellemenin ISO 8601 zaman damgası. null olabilir.
object
gerekli
Bu randevuyla ilişkili hasta profili.
AppointmentPanel[]
gerekli
Şu anda bu randevuya bağlı paneller. İptal edilen bağlantılar hariçtir. Panel ayrıntılarını (ad, biyobelirteçler) Panelleri listele üzerinden incele.
AppointmentIndividualBiomarker[]
gerekli
Herhangi bir panel dışında bu randevuya eklenen tekil biyobelirteçler (bkz. Özel biyobelirteç ekle). Görüntüleme verileri için her biomarker_id değerini Biyobelirteçleri listele ile eşleştir.
AppointmentShipmentLink[]
gerekli
Bu randevuya bağlı gönderiler, en eski bağlantıdan başlayarak sıralanır. Bağlı gönderi olmadığında boş dizidir. Tam gönderi verisi (durum, takip numarası, durum güncellemeleri vb.) için her id değerini Gönderiyi getir ile eşleştir.
string[]
gerekli
Bu randevu için tarama sırasına göre kaydedilen laboratuvar kodları (tüp barkodları). Kan alma onaylanana kadar boştur. Venöz kan almada her tüpe basılı tek bir kod bulunur; kapiler kan almada mikrotüp başına bir kod bulunur. Sonuçları al üzerindeki sonuçlar ve belgeler bu kodlara lab_code üzerinden başvurur.

Tekrarlanan çağrılar

Aniva, bu uç noktanın yanıtını her API anahtarı için 15 dakika saklar. Bu süre içindeki tekrarlanan bir çağrı, randevu değişmediği sürece saklanan yanıtı alır. Bir değişiklikten sonra güncel 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şikliği anında öğrenmek için appointment.created, appointment.rescheduled ve örneğin appointment.confirmed gibi her durumun webhook olaylarına abone ol. Bkz. Tekrarlanan okumalar.

Hata yanıtları