Ana içeriğe atla
POST
Belirli bir test konumunda bir hasta profili için kan alma randevusu planla. Randevu oluşturulduğunda varsayılan olarak confirmed durumuna geçer (bazı konumlar bunun yerine varsayılan olarak pending kullanabilir — bu konuma özel bir ayardır). Kan almayı onaylamadan önce kan tahlili panellerini eklemek için Panel ekle uç noktasını kullan.
Bir profil aynı konum ve saat için en fazla bir randevu alabilir. Profilin zaten randevusunun olduğu bir zaman dilimi için randevu oluşturmak, ikinci bir randevu yerine mevcut appointment_id ile 409 döndürür — böylece yeniden denenen veya yanlışlıkla tekrarlanan bir istek asla çift randevu oluşturmaz. Yinelenen randevular bölümüne bak.
Bu oluşturma işlemini güvenle yeniden denenebilir kılmak için isteğe bağlı bir Idempotency-Key başlığı gönder — aynı anahtarın tekrarı ikincisini oluşturmak yerine ilk yanıtı döndürür. İdempotans bölümüne bak. appointments_schedule kapsamını gerektirir.

İstek

Gövde parametreleri

string
gerekli
Randevunun oluşturulacağı hasta profilinin UUID’si.
string
gerekli
Kan almanın yapılacağı test konumunun UUID’si. Mevcut konum ID’lerini bulmak için Konumları listele uç noktasını kullan.
string
gerekli
Randevunun ISO 8601 biçimindeki tarih ve saati (ör. 2026-05-15T10:30:00Z veya 2026-05-15T12:30:00+02:00). Saat dilimi göstergesi içermelidir — Z veya +02:00 gibi açık bir fark belirtilmelidir; saat dilimi olmayan tarih-saat değerleri reddedilir. Gelecekte bir zaman olmalıdır.Konumun zaman çizelgesindeki tam bir zaman dilimi başlangıcı olmalı ve zaman diliminde hâlâ kontenjan bulunmalıdır — önce Müsaitliği getir yanıtını oku. Çizelge dışı saatler 400, dolmuş bir zaman dilimi 409 döndürür. Aniva’nın işlettiği konumlarda ayrıca en az 12 saat sonrası olmalıdır — Minimum bildirim süresi bölümüne bak.
string[]
Tüm laboratuvar sonuçları kesinleştiğinde her biri bir e-posta alacak en fazla 5 adres. E-posta, Aniva yönetim panelindeki sonuç sayfasına yönlendirir. Anahtarının hasta için results_view erişimine sahip olması gerekir, aksi halde 403 döner. Hastanın grubu için ayarlanan varsayılan adresleri kullanmak için bu alanı gönderme. Boş bir liste e-postaları kapatır. Sonuçlar hazır e-postaları bölümüne bak.
string
Kanın nasıl alınacağı: capillary veya venous. Konumun default_draw_method değerini kullanmak için bu alanı gönderme. Konumun bu yöntemi draw_methods listesinde barındırması gerekir, aksi halde 400 döner.

Yanıt

Başarılı olduğunda API, yeni randevuyla birlikte 201 Created 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.
object
gerekli
Bu randevuyla ilişkili hasta profili.
AppointmentPanel[]
gerekli
Bu randevuya şu anda bağlı olan paneller. Yeni oluşturulan randevularda boştur — Panel ekle ile bağla. Panel ayrıntılarını (ad, biyobelirteçler) Panelleri listele üzerinden görüntüle.
AppointmentIndividualBiomarker[]
gerekli
Herhangi bir panel dışında bu randevuya eklenen tekil biyobelirteçler. Yeni oluşturulan randevularda boştur — Tekil biyobelirteç ekle ile 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. Yeni oluşturulan randevularda boştur — Gönderi oluştur (appointment_id ile) veya Gönderiye randevu bağla ile bağla.
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.

Minimum bildirim süresi

Aniva’nın işlettiği konumlarda randevular en az 12 saat önceden alınmalıdır; bu süre içinde randevu almak 400 döndürür. Müsaitliği getir bu zaman dilimlerini zaten gizler, yani bu çizelgeden okuduğun her zaman dilimi için randevu alınabilir. Kendi işlettiğin konumlarda minimum bildirim süresi yoktur — aynı gün ve yerinde randevu alma aynı şekilde devam eder.

Yinelenen randevular

Bir profil aynı konum ve an için iptal edilmemiş en fazla bir randevu tutabilir — konumda kaç koltuk olursa olsun, aynı kişiden aynı yerde ve aynı anda iki kez kan alınamaz. Profilin zaten randevusunun olduğu bir zaman dilimi için randevu oluşturmak, mevcut randevuyu belirten bir appointment_id ile 409 döndürür:
İsteği zaten uygulanmış kabul ederek ele al: randevuyu Randevuyu getir ile çek, Randevuyu güncelle ile taşı veya Randevuyu iptal et ile iptal et. Oluşturma isteğini yeniden deneme — 409 döndürmeye devam eder. Bu, tekrarlanan oluşturma isteklerini güvenli kılar: zaman aşımı sonrası yeniden gönderdiğin bir istek veya iki kez gönderilen bir form, aynı hasta için aynı saatte iki randevu oluşturamaz.
appointment_id yalnızca yinelenen randevu 409 yanıtında bulunur. Kontenjan kaynaklı 409 — zaman dilimi diğer hastalar tarafından doldurulduğu için doluysa — yalnızca error döndürür; buradaki doğru çözüm Müsaitliği getir üzerinden başka bir zaman dilimi seçmektir.

Hata yanıtları