Pāriet uz galveno saturu
PATCH
Pievieno pierakstam vienu vai vairākus individuālus biomarķierus kā atsevišķas analīzes ārpus gatavajiem paneļiem. Maršrutēšanas lēmumus tālāk pieņem pasūtījumu loģistikas plūsma, pamatojoties uz katra biomarķiera piesaisti konkrētām laboratorijām. Iegūtā kopa tiek sinhroni validēta atbilstoši katras laboratorijas noslēgtības noteikumiem. Dažus biomarķierus var iegūt, tikai pasūtot tos kopā ar citiem — piemēram, LDL/HDL attiecību sniedz pasūtījums, kas ietver arī LDL un HDL, tāpēc pieprasīt tikai attiecību vienu pašu nav pilnvērtīgs pasūtījums. (Tieši šīs sastāvdaļas nosaka attiecības cenu — skati pricing sadalījumu sadaļā Biomarķieru saraksts.) Ja kopu nevar korekti pasūtīt, izsaukums atgriež 400 ar validation datiem un nekas netiek saglabāts, tāpēc vari izmēģināt vairākus variantus, līdz izveido derīgu kopu:
  1. PATCH … { "biomarker_ids": [45] } (tikai LDL/HDL attiecība) → 400; validation.failures[].fix_options[].add_biomarkers norāda LDL un HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (attiecība + LDL + HDL) → 200.
Tas pats cikls attiecas uz biomarķieriem, kurus Aniva pārdod tikai pozīcijas ietvaros: pieprasi kādu atsevišķi, un izsaukums atgriezīs 400 ar error: "biomarker_requires_position" un pozīcijām, kurās tas tiek pārdots. Skati Cenas. Biomarķieru saraksts dažiem biomarķieriem norāda price_cents: null. Šie biomarķieri ir nekūrēti: Aniva tiem nav noteikusi cenu. Ja pievieno kādu no tiem, izsaukums atgriež 400 ar error: "biomarker_not_priced". Neviens cits biomarķieris šo kļūdu nenovērš, jo null nozīmē, ka nav cenas, par kādu šo marķieri iegādāties. Izņēmums ir komplekta marķieri. Pievieno paneli, kas ir pats komplekts, un tā sastāvdaļas tiks pievienotas kopā ar paneli. Izsaukums pieņem arī sastāvdaļu, ko pievieno pierakstam, kurā šis panelis jau ir iekļauts. Kapilārajā asins paņemšanā (draw_method: capillary) paņemtās asinis tiek sadalītas mikrostobriņos. Vispirms tiek ievietoti paneļi rezervācijas secībā. Pēc tam individuālie biomarķieri aizpilda brīvo vietu paneļu mikrostobriņos. Ja tiem nepieciešams vairāk vietas, tiek atvērti jauni mikrostobriņi. Mēs tos sadalām vienmērīgi. Katrā mikrostobriņā var būt ne vairāk kā 150 µl individuālo biomarķieru. Biomarķieris, kuram atsevišķā mikrostobriņā nepieciešams vairāk nekā 150 µl, nekad neietilpst, tāpat kā biomarķieris bez noteikta tilpuma. Ja iegūtā kopa pārkāpj šo noteikumu, izsaukums atgriež 400 ar error ziņojumu un nekas netiek saglabāts. Šis izsaukums ir idempotents: pierakstā jau esošie biomarķieri tiek saglabāti. Nepieciešami piekļuves tvērumi appointments_schedule un schedule_appointments_with_individual_biomarker_selection.
Biomarķierus nevar pievienot pēc tam, kad izsauc Apstiprināt asins paņemšanu. Mēģinājums mainīt apstiprinātu pierakstu atgriež 409 Conflict.

Pieprasījums

Ceļa parametri

string
obligāts
Pieraksta unikālais identifikators (UUID).

Pieprasījuma satura parametri

number[]
obligāts
Pievienojamo biomarķieru ID masīvs. Jāsatur vismaz viens elements. Izmanto Biomarķieru sarakstu, lai atrastu ID.

Atbilde

Veiksmīgas izpildes gadījumā API atgriež 200 OK, apstiprinot, ka biomarķieri ir pievienoti.
boolean
true, kad biomarķieri ir veiksmīgi pievienoti pierakstam.

Kā lasīt 400

Katra noslēgtības validācijas un kataloga 400 atbilde ietver teikumu laukā message. Satura validācijas vai mikrostobriņu 400 atbilde ietver tikai error. Sazaro loģiku pēc error. Noslēgtības validācijas kļūdas gadījumā error ir teikums. Kataloga kļūdas gadījumā error ir mašīnlasāms kods: biomarker_not_priced vai biomarker_requires_position. Noslēgtības validācija — kopu nevar korekti pasūtīt nevienā laboratorijā:
  • validation.failures[] — pieejams tikai noslēgtības validācijas kļūdu gadījumā (nav iekļauts parastās satura validācijas kļūdās). Viens ieraksts katrai biomarķieru grupai, kuru nevar apkalpot neviena laboratorija, ietverot biomarker_ids, kuriem validācija neizdevās, un fix_options[] ar mazāko variantu sākumā. Katra varianta add_biomarkers ({ id, name }) ir kopa, kas jāpievieno PILNĪBĀ — saglabā sākotnējos, pievieno šos un mēģini vēlreiz. Tukšs fix_options nozīmē, ka pievienošana nepalīdzēs; tā vietā noņem biomarķieri.
Biomarķieris bez cenas — Aniva šim biomarķierim nav noteikusi cenu. Biomarķieru saraksts tam norāda price_cents: null vai izlaiž to, ja tā ir attiecība ar sastāvdaļu bez cenas. error ir biomarker_not_priced, un biomarker_id norāda šo marķieri. Neviens cits biomarķieris šo kļūdu nenovērš, tāpēc noņem šo biomarķieri. Biomarķieris ir pasūtāms, ja izpildās divi nosacījumi: laboratorijai, uz kuru Aniva var novirzīt pasūtījumu, tas ir jānodrošina, un Aniva katalogā tam ir jābūt noteiktai cenai. Ierobežots biomarķieris — biomarķieris, ko pārdod tikai pozīcijas ietvaros, un kopā nav pozīcijas, kas to nosegtu. error ir biomarker_requires_position, biomarker_id norāda marķieri, un positions[] uzskaita visas pozīcijas, kurās to pārdod, sākot ar lētāko. Pievieno visus vienas pozīcijas biomarķierus. Skati Cenas, lai iepazītos ar modeli, un pricing.positions sadaļā Iegūt biomarķieri, lai redzētu pilnu pozīcijas sastāvdaļu kopu.

Kļūdu atbildes