Ana içeriğe atla
PATCH
Bir randevuya herhangi bir hazır panelin dışında, tekil testler olarak bir veya daha fazla bireysel biyobelirteç ekle. Yönlendirme kararları, her biyobelirtecin laboratuvar bazlı eşleştirmelerine göre sipariş-lojistik akışı tarafından sonraki aşamada verilir. Oluşan küme, her laboratuvarın kapalılık kurallarına göre eşzamanlı olarak doğrulanır. Bazı biyobelirteçler yalnızca diğerleriyle birlikte sipariş edilerek alınabilir — örneğin LDL/HDL oranı, LDL ve HDL’yi de döndüren bir siparişle sağlanır; dolayısıyla oranı tek başına istemek tutarlı bir sipariş değildir. (Oran da tam olarak bu bileşenler üzerinden fiyatlandırılır — Biyobelirteçleri listele sayfasındaki pricing dökümüne bak.) Küme sorunsuz şekilde sipariş edilemediğinde çağrı bir validation verisiyle birlikte 400 döndürür ve hiçbir şey kaydedilmez; böylece deneme yanılmayla geçerli bir kümeye ulaşabilirsin:
  1. PATCH … { "biomarker_ids": [45] } (yalnızca LDL/HDL oranı) → 400; validation.failures[].fix_options[].add_biomarkers LDL ve HDL’yi listeler.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (oran + LDL + HDL) → 200.
Aynı döngü, Aniva’nın yalnızca bir pozisyon içinde sattığı biyobelirteçler için de geçerlidir: bunlardan birini tek başına istediğinde çağrı, error: "biomarker_requires_position" ve bunu satan pozisyonlarla birlikte 400 döndürür. Fiyatlandırma sayfasına bak. Biyobelirteçleri listele bazı biyobelirteçleri price_cents: null olarak gösterir. Bu biyobelirteçler düzenlenmemiştir: Aniva bunları fiyatlandırmamıştır. Bunlardan birini eklersen çağrı error: "biomarker_not_priced" ile 400 döndürür. Başka hiçbir biyobelirteç bu hatayı düzeltmez; çünkü null, belirteci satın alabileceğin bir fiyat olmadığı anlamına gelir. Kit belirteçleri istisnadır. Kit olan paneli eklediğinde üyeleri de panelle birlikte gelir. Çağrı, o paneli zaten içeren bir randevuya eklediğin bir üyeyi de kabul eder. Kapiler kan almada (draw_method: capillary), alınan kan mikrotüplere doldurulur. Önce paneller, rezervasyon sırasına göre yerleştirilir. Ardından bireysel biyobelirteçler, panel mikrotüplerindeki boş alanı doldurur. Daha fazla alana ihtiyaç duyduklarında yeni mikrotüpler açılır. Bunları eşit olarak dağıtırız. Her mikrotüp en fazla 150 µl bireysel biyobelirteç alır. Kendi başına bir mikrotüpte 150 µl’den fazla hacim gerektiren bir biyobelirteç hiçbir zaman sığmaz; tanımlı hacmi olmayan bir biyobelirteç de öyle. Oluşan küme bu kuralı bozarsa çağrı bir error mesajıyla 400 döndürür ve hiçbir şey kaydedilmez. Bu çağrı idempotenttir: randevuda zaten bulunan biyobelirteçler korunur. appointments_schedule ve schedule_appointments_with_individual_biomarker_selection kapsamlarını gerektirir.
Kan almayı onayla çağrısını yaptıktan sonra biyobelirteç eklenemez. Onaylanmış bir randevuyu değiştirmeye çalışmak 409 Conflict döndürür.

İstek

Yol parametreleri

string
gerekli
Randevunun benzersiz kimliği (UUID).

Gövde parametreleri

number[]
gerekli
Eklenecek biyobelirteç ID’leri dizisi. En az bir öğe içermelidir. ID’leri bulmak için Biyobelirteçleri listele uç noktasını kullan.

Yanıt

Başarılı olduğunda API, biyobelirteçlerin eklendiğini onaylayan 200 OK yanıtını döndürür.
boolean
Biyobelirteçler randevuya başarıyla eklendiğinde true.

400 yanıtını okuma

Her kapalılık doğrulaması ve katalog 400 hatası message alanında bir cümle taşır. Gövde doğrulaması veya mikrotüp 400 hatası yalnızca error alanını taşır. Dallanmayı error üzerinden yap. Kapalılık doğrulaması hatasında error bir cümledir. Katalog hatasında error bir makine kodudur: biomarker_not_priced veya biomarker_requires_position. Kapalılık doğrulaması — küme hiçbir laboratuvarda sorunsuz şekilde sipariş edilemez:
  • validation.failures[] — yalnızca kapalılık doğrulaması hatalarında bulunur (düz gövde doğrulaması hatalarında yer almaz). Hiçbir laboratuvarın sunamadığı her biyobelirteç grubu için başarısız olan biomarker_ids değerlerini ve en küçük seçenekten başlayarak fix_options[] dizisini taşıyan bir girdi içerir. Her seçeneğin add_biomarkers ({ id, name }) alanı, TAMAMINI eklemen gereken bir kümedir — mevcut seçimlerini koru, bunları ekle ve yeniden dene. Boş bir fix_options, hiçbir eklemenin işe yaramayacağı anlamına gelir; bunun yerine biyobelirteci kaldır.
Fiyatlandırılmamış biyobelirteç — Aniva bu biyobelirteci fiyatlandırmamıştır. Biyobelirteçleri listele bunu price_cents: null olarak gösterir veya fiyatlandırılmamış bir bileşene sahip bir oransa bunu dahil etmez. error değeri biomarker_not_priced olur ve biomarker_id ilgili belirteci belirtir. Başka hiçbir biyobelirteç bu hatayı düzeltmez; bu yüzden biyobelirteci kaldır. Bir biyobelirteci sipariş edilebilir kılan iki koşul vardır: Aniva’nın yönlendirebileceği bir laboratuvar bunu sunmalıdır ve Aniva kataloğu bunu fiyatlandırmış olmalıdır. Kısıtlı biyobelirteç — yalnızca bir pozisyon içinde satılan ve kümede kendisini kapsayan bir pozisyon bulunmayan biyobelirteç. error değeri biomarker_requires_position olur, biomarker_id ilgili belirteci belirtir ve positions[] bunu satan tüm pozisyonları en ucuzundan başlayarak listeler. Bunlardan birinin tüm biyobelirteçlerini ekle. Model için Fiyatlandırma sayfasına, bir pozisyonun tüm üye kümesi içinse Biyobelirteç getir sayfasındaki pricing.positions alanına bak.

Hata yanıtları