Ugrás a fő tartalomhoz
PATCH
Adj hozzá egy vagy több egyéni biomarkert egy időponthoz külön választható tesztként, bármely előre összeállított panelen kívül. A továbbítási döntéseket később a rendeléslogisztikai folyamat hozza meg, az egyes biomarkerek laboronkénti hozzárendelései alapján. Az így kapott halmazt a rendszer szinkron módon ellenőrzi az egyes laborok zártsági szabályai alapján. Egyes biomarkerek csak másokkal együtt rendelhetők meg – az LDL/HDL-arányt például olyan rendelés adja vissza, amely az LDL-t és a HDL-t is tartalmazza, így az arány önmagában történő kérése nem érvényes rendelés. (Az arány árazása is ugyanezek alapján az összetevők alapján történik – lásd a pricing bontást a Biomarkerek listázása oldalon.) Ha a halmaz nem rendelhető meg hibátlanul, a hívás 400-as választ ad egy validation tartalommal, és semmi nem kerül mentésre, így próbálgatással eljuthatsz egy érvényes halmazhoz:
  1. PATCH … { "biomarker_ids": [45] } (csak az LDL/HDL-arány) → 400; a validation.failures[].fix_options[].add_biomarkers felsorolja az LDL-t és a HDL-t.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (arány + LDL + HDL) → 200.
Ugyanez a folyamat vonatkozik azokra a biomarkerekre is, amelyeket az Aniva csak tétel részeként értékesít: ha egyet önmagában kérsz, a hívás 400-as választ ad error: "biomarker_requires_position" hibával és az azt értékesítő tételekkel. Lásd: Árazás. A Biomarkerek listázása egyes biomarkereknél price_cents: null értéket ad meg. Ezek a biomarkerek nem kuráltak: az Aniva nem árazta be őket. Ha hozzáadsz egyet, a hívás 400-as választ ad error: "biomarker_not_priced" hibával. Ezt a hibát egyetlen másik biomarker sem oldja meg, mert a null azt jelenti, hogy nincs megadott ár, amelyen a markert megvásárolhatnád. A készlethez tartozó markerek kivételt jelentenek. Add hozzá a készletnek megfelelő panelt, és annak elemei a panellel együtt érkeznek. A hívás olyan elemet is elfogad, amelyet egy ezt a panelt már tartalmazó időponthoz adsz hozzá. Kapilláris vérvételnél (draw_method: capillary) a minta mikrocsövekbe kerül. Először a panelek kerülnek sorra, a foglalás sorrendjében. Az egyéni biomarkerek ezután a panelek mikrocsöveiben maradt szabad helyet töltik ki. Ha több helyre van szükségük, új mikrocsöveket nyitnak. Egyenletesen osztjuk el őket. Egy mikrocsőbe legfeljebb 150 µl egyéni biomarker fér. Az a biomarker, amely önálló mikrocsőben több mint 150 µl-t igényel, soha nem fér el, ahogy a kurált térfogat nélküli biomarker sem. Ha az így kapott halmaz megszegi ezt a szabályt, a hívás 400-as választ ad egy error üzenettel, és semmi nem kerül mentésre. Ez a hívás idempotens: az időponthoz már hozzáadott biomarkerek megmaradnak. Az appointments_schedule és a schedule_appointments_with_individual_biomarker_selection jogosultsági körök szükségesek hozzá.
A Vérvétel megerősítése hívása után már nem adhatók hozzá biomarkerek. Ha egy megerősített időpontot próbálsz módosítani, a hívás 409 Conflict választ ad.

Kérés

Útvonalparaméterek

string
kötelező
Az időpont egyedi azonosítója (UUID).

Törzsparaméterek

number[]
kötelező
A hozzáadni kívánt biomarker-azonosítók tömbje. Legalább egy elemet tartalmaznia kell. Az azonosítók lekérdezéséhez használd a Biomarkerek listázása végpontot.

Válasz

Siker esetén az API 200 OK válasszal erősíti meg, hogy a biomarkereket hozzáadta.
boolean
true, ha a biomarkerek hozzáadása az időponthoz sikeres volt.

A 400-as válasz értelmezése

Minden zártság-ellenőrzési és katalógus-400 egy mondatot tartalmaz a message mezőben. A törzsellenőrzési vagy mikrocső-400 csak az error mezőt tartalmazza. Az error alapján ágazz el. Zártság-ellenőrzési hiba esetén az error egy mondat. Katalógushiba esetén az error egy gépi kód: biomarker_not_priced vagy biomarker_requires_position. Zártság-ellenőrzés – a halmaz egyetlen laborban sem rendelhető meg hibátlanul:
  • validation.failures[] – csak zártság-ellenőrzési hibáknál szerepel (egyszerű törzsellenőrzési hibáknál nincs jelen). Minden olyan biomarkercsoporthoz egy bejegyzés tartozik, amelyet egyik labor sem tud kiszolgálni, a sikertelen biomarker_ids értékekkel és a fix_options[] listával, a legkisebb opcióval kezdve. Minden opció add_biomarkers ({ id, name }) mezője egy olyan halmaz, amelynek az ÖSSZES elemét hozzá kell adnod – tartsd meg az eredetieket, add hozzá ezeket, és próbáld újra. Az üres fix_options azt jelenti, hogy semmilyen hozzáadás nem segít; ehelyett távolítsd el a biomarkert.
Árazatlan biomarker – az Aniva nem árazta be ezt a biomarkert. A Biomarkerek listázása price_cents: null értékkel adja meg, vagy kihagyja, ha olyan arányról van szó, amelynek van árazatlan összetevője. Az error értéke biomarker_not_priced, a biomarker_id pedig megnevezi a markert. Ezt a hibát egyetlen másik biomarker sem oldja meg, ezért távolítsd el a biomarkert. Két feltétel tesz rendelhetővé egy biomarkert: egy olyan labornak kell elvégeznie, ahová az Aniva továbbítani tud, és az Aniva katalógusának be kell áraznia. Tételhez kötött biomarker – olyan biomarker, amelyet csak tétel részeként értékesítenek, és nincs azt lefedő tétel a halmazban. Az error értéke biomarker_requires_position, a biomarker_id megnevezi a markert, a positions[] pedig felsorolja az összes olyan tételt, amely értékesíti, a legolcsóbbtól kezdve. Add hozzá ezek egyikének minden biomarkerét. A modell részleteit lásd az Árazás oldalon, egy tétel teljes elemkészletét pedig a Biomarker lekérése végpont pricing.positions mezőjében.

Hibaválaszok