Ana içeriğe atla
PATCH
Planlanan saat veya test konumu gibi randevu bilgilerini güncelle. Yalnızca kan alması henüz onaylanmamış randevular değiştirilebilir.
Kan alma onaylandıktan sonra veya randevu zaten iptal edildiyse randevular değiştirilemez. Böyle bir randevuyu güncellemeye çalışmak 409 Conflict döndürür. Tek istisna, kan almadan sonra da değiştirebileceğin results_ready_emails alanıdır.
appointments_schedule veya appointments_manage kapsamını gerektirir.

İstek

Yol parametreleri

string
gerekli
Güncellenecek randevunun benzersiz kimliği (UUID).

Gövde parametreleri

Tüm gövde parametreleri isteğe bağlıdır — yalnızca değiştirmek istediğin alanları ekle.
string
ISO 8601 biçiminde yeni randevu tarih ve saati (ör. 2026-05-20T14:00:00Z veya 2026-05-20T16:00:00+02:00). Saat dilimi belirtici içermelidir — ya Z ya da +02:00 gibi açık bir fark; saat dilimi olmayan tarih-saatler reddedilir. Gelecekte bir zaman olmalıdır.Kalan kapasitesi olan tam bir zaman dilimi başlangıcı olmalıdır — Müsaitliği al sayfasına bak. Yeniden planlanan randevu hiçbir zaman kendi hedef zaman diliminin kapasitesinden düşmez; ancak aynı profilin halihazırda farklı bir randevusunun bulunduğu bir zaman dilimine taşımak, o randevunun appointment_id değeriyle 409 döner.Hedef konum Aniva tarafından işletiliyorsa yeni saat de en az 12 saat sonrası olmalıdır — Minimum bildirim süresi sayfasına bak.
string
Yeni test konumunun UUID’si. Konum mevcut ve etkin olmalıdır. Mevcut konum kimliklerini bulmak için Konumları listele uç noktasını kullan.
string[]
Tüm laboratuvar sonuçları kesinleştiğinde her birine bir e-posta gönderilecek en fazla 5 adreslik listeyi değiştirir. E-postaları kapatmak için [] gönder. Bu alan kan almadan sonra da düzenlenebilir kalır; yalnızca iptal edilmiş bir randevu bunu reddeder. Kan almadan sonra tek başına gönder: aynı gövdede scheduled_at veya location_id bulunursa istek 409 döner. Anahtarının hastaya yönelik results_view erişimine sahip olması gerekir, aksi halde 403 döner. Sonuçlar hazır e-postaları sayfasına bak.
string | null
Yeni kan alma yöntemi: capillary veya venous ya da konumun default_draw_method değerini yeniden kullanmak için null. Konumun bu yöntemi draw_methods listesinde bulundurması ve planlanan testlerin bu yöntemle yapılabilmesi gerekir, aksi halde 400 döner. Bir randevuyu başka bir konuma taşıdığında aynı kontrol orada da çalışır: randevunun kendi draw_method değeri üzerinde, yoksa yeni konumun default_draw_method değeri üzerinde.

Yanıt

Başarılı olduğunda API, güncellenmiş randevu ve gömülü profiliyle birlikte 200 OK döner.
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 sonekli ISO 8601, ör. 2026-05-20T14:00: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ı ilk sırada olacak şekilde. Bağlı gönderi yoksa boş dizi döner. Tam gönderi yükü için her id değerini Gönderiyi al üzerinden sorgula.
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.

Hata yanıtları