Ana içeriğe atla
GET
Kan alma randevularının listesini al. Her randevu, gömülü hasta profilini içerir. Filtreler birlikte çalışır:
  • date, tek bir takvim günündeki randevuları döndürür. Gün, her randevunun konumundaki yerel gündür; yani Berlin’de saat 23:30’daki bir kan alma, Berlin tarihine sayılır.
  • location_id, tek bir test konumundaki randevuları döndürür.
  • date olmadan profile_id, o profil için tüm randevuları zaman kısıtlaması olmadan döndürür.
  • profile_id ve date verilmediğinde varsayılan zaman aralığı uygulanır: son 2 aydan gelecek 1 aya kadar.
appointments_view veya appointments_schedule kapsamını gerektirir.

İstek

Sorgu parametreleri

string
Profil UUID’sine göre filtrele. Verildiğinde, planlama tarihine bakılmaksızın bu profilin tüm randevuları döndürülür. Verilmediğinde varsayılan zaman aralığı uygulanır.
string
Test konumu UUID’sine göre filtrele.
string
Her randevunun konum saat diliminde, YYYY-MM-DD biçiminde takvim günü. Varsayılan zaman aralığının yerini alır. Sonuçlar scheduled_at alanına göre en erkenden başlayarak sıralanır.

Yanıt

Başarılı olduğunda API, randevu nesnelerinden oluşan bir diziyle 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 5 dakika boyunca saklar. Bu süre içinde yapılan yinelenen bir çağrı saklanan yanıtı alır. 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ı