Siirry pääsisältöön
PATCH
Lisää yksi tai useampi yksittäinen biomarkkeri ajanvaraukseen à la carte -testeinä valmiiden paneelien ulkopuolelta. Reitityspäätökset tehdään myöhemmin tilauslogistiikkaputkessa kunkin biomarkkerin laboratoriokohtaisten vastaavuuksien perusteella. Muodostuva joukko validoidaan synkronisesti kunkin laboratorion sulkeumasääntöjä vasten. Joitakin biomarkkereita saa vain tilaamalla ne yhdessä muiden kanssa — esimerkiksi LDL/HDL-suhde toimitetaan tilauksella, joka palauttaa myös LDL:n ja HDL:n, joten pelkän suhteen pyytäminen ei ole yhtenäinen tilaus. (Suhde on hinnoiteltu juuri näiden samojen osatekijöiden mukaan — katso pricing-erittely sivulta Listaa biomarkkerit.) Kun joukkoa ei voi tilata ongelmitta, kutsu palauttaa 400 ja validation-sisällön eikä mitään tallenneta, joten voit hakea kelvollisen joukon kokeilemalla:
  1. PATCH … { "biomarker_ids": [45] } (pelkkä LDL/HDL-suhde) → 400; validation.failures[].fix_options[].add_biomarkers listaa LDL:n ja HDL:n.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (suhde + LDL + HDL) → 200.
Sama silmukka koskee biomarkkereita, joita Aniva myy vain osana nimikettä: jos pyydät yhtä yksinään, kutsu palauttaa 400, error: "biomarker_requires_position" sekä nimikkeet, joissa sitä myydään. Katso Hinnoittelu. Listaa biomarkkerit ilmoittaa joillekin biomarkkereille arvon price_cents: null. Nämä biomarkkerit ovat kuratoimattomia: Aniva ei ole hinnoitellut niitä. Jos lisäät sellaisen, kutsu palauttaa 400 ja error: "biomarker_not_priced". Mikään muu biomarkkeri ei korjaa tätä virhettä, koska null tarkoittaa, ettei sinulla ole hintaa markkerin ostamiseen. Testipakkauksen markkerit ovat poikkeus. Liitä testipakkauksena toimiva paneeli, niin sen jäsenet tulevat paneelin mukana. Kutsu hyväksyy myös jäsenen, jonka lisäät ajanvaraukseen, jolla kyseinen paneeli jo on. Kapillaarinäytteenotossa (draw_method: capillary) verinäyte pakataan mikroputkiin. Paneelit menevät ensin varausjärjestyksessä. Yksittäiset biomarkkerit täyttävät sitten paneelien mikroputkien vapaan tilan. Kun ne tarvitsevat lisää tilaa, ne avaavat uusia mikroputkia. Jaamme ne tasaisesti. Jokaiseen mikroputkeen mahtuu enintään 150 µl yksittäisiä biomarkkereita. Biomarkkeri, joka tarvitsee yli 150 µl omassa mikroputkessaan, ei mahdu koskaan, eikä myöskään biomarkkeri ilman kuratoitua tilavuutta. Jos muodostuva joukko rikkoo tätä sääntöä, kutsu palauttaa 400 ja error-viestin eikä mitään tallenneta. Tämä kutsu on idempotentti: ajanvarauksella jo olevat biomarkkerit säilytetään. Vaatii scope-oikeudet appointments_schedule ja schedule_appointments_with_individual_biomarker_selection.
Biomarkkereita ei voi lisätä sen jälkeen, kun olet tehnyt Vahvista verinäytteenotto -kutsun. Vahvistetun ajanvarauksen muokkausyritys palauttaa 409 Conflict.

Pyyntö

Polkuparametrit

string
vaadittu
Ajanvarauksen yksilöllinen tunniste (UUID).

Runkoparametrit

number[]
vaadittu
Taulukko liitettävien biomarkkereiden tunnisteista. Täytyy sisältää vähintään yksi alkio. Hae tunnisteet Listaa biomarkkerit -kutsulla.

Vastaus

Onnistuessaan API palauttaa 200 OK vahvistuksena siitä, että biomarkkerit on liitetty.
boolean
true, kun biomarkkerit on lisätty ajanvaraukseen onnistuneesti.

400-vastauksen lukeminen

Jokainen sulkeumavalidoinnin ja luettelon 400-vastaus sisältää lauseen kentässä message. Runkovalidoinnin tai mikroputkien 400-vastaus sisältää vain kentän error. Haaroita error-arvon perusteella. Sulkeumavalidointivirheessä error on lause. Luettelovirheessä error on koneluettava koodi: biomarker_not_priced tai biomarker_requires_position. Sulkeumavalidointi — joukkoa ei voi tilata ongelmitta mistään laboratoriosta:
  • validation.failures[] — mukana vain sulkeumavalidointivirheissä (puuttuu tavallisissa runkovalidointivirheissä). Yksi merkintä jokaista biomarkkeriryhmää kohden, jota yksikään laboratorio ei voi toimittaa; sisältää epäonnistuneet biomarker_ids-arvot ja fix_options[]-vaihtoehdot pienin vaihtoehto ensin. Kunkin vaihtoehdon add_biomarkers ({ id, name }) on joukko, josta lisäät KAIKKI — pidä alkuperäiset, lisää nämä ja yritä uudelleen. Tyhjä fix_options tarkoittaa, ettei minkään lisääminen auta; poista sen sijaan biomarkkeri.
Hinnoittelematon biomarkkeri — Aniva ei ole hinnoitellut tätä biomarkkeria. Listaa biomarkkerit ilmoittaa sen arvolla price_cents: null tai jättää sen pois, jos kyseessä on suhde, jossa on hinnoittelematon osatekijä. error on biomarker_not_priced, ja biomarker_id nimeää markkerin. Mikään muu biomarkkeri ei korjaa tätä virhettä, joten poista biomarkkeri. Kaksi ehtoa tekee biomarkkerista tilattavan: laboratorion, johon Aniva voi reitittää, on toimitettava se, ja sen on oltava hinnoiteltu Anivan luettelossa. Rajoitettu biomarkkeri — biomarkkeri, jota myydään vain osana nimikettä ilman kattavaa nimikettä joukossa. error on biomarker_requires_position, biomarker_id nimeää markkerin, ja positions[] listaa kaikki nimikkeet, joissa sitä myydään, halvin ensin. Lisää yhden niistä kaikki biomarkkerit. Katso malli sivulta Hinnoittelu ja nimikkeen koko jäsenjoukko kentästä pricing.positions sivulla Hae biomarkkeri.

Virhevastaukset