Ana içeriğe atla
DELETE
Durumunu cancelled olarak ayarlayarak bir randevuyu iptal et. Yalnızca kan alma işlemi henüz onaylanmamış randevular iptal edilebilir. Zaten cancelled durumundaki bir randevuyu iptal etmek, o randevuyla birlikte 200 döndürür ve hiçbir şey yazmaz — ikinci bir iptal kaydedilmez. Yanıt Idempotent-Replayed: true içerir; böylece bir tekrarı asıl işlemi yapan çağrıdan ayırt edebilirsin. Farklı bir cancellation_reason içeren bir tekrar ise bunun yerine 409 döndürür: kayıtlı nedenin üzerine asla yazılmaz. Bkz. İdempotans.
Kan alma onaylandıktan sonra randevular iptal edilemez — bu durumda 409 Conflict döner.
appointments_schedule veya appointments_manage kapsamını gerektirir.

İstek

Yol parametreleri

string
gerekli
İptal edilecek randevunun benzersiz tanımlayıcısı (UUID).

Gövde parametreleri

Gövde isteğe bağlıdır — bir neden kaydetmeden iptal etmek için hiç gövde gönderme.
string
En fazla 500 karakter uzunluğunda serbest metin iptal nedeni (ör. Patient no-show). Randevuda saklanır ve bu okuma ile sonraki okumalarda cancellation_reason olarak döndürülür.

Yanıt

Başarılı olduğunda API, iptal edilen randevuyu ve gömülü profilini içeren 200 OK yanıtı 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
Randevu durumu. Başarılı bir iptalden sonra cancelled olur.
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
İptalden önce bu randevuya eklenmiş paneller. Panel ayrıntılarını (ad, biyobelirteçler) Panelleri listele üzerinden sorgula.
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
İptalden önce bu randevuya bağlanmış gönderiler. Her id, Gönderiyi al ile eşleşir.
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ı