Hopp til hovedinnhold
PATCH
Legg til én eller flere individuelle biomarkører på en time som à la carte-tester, utenfor et forhåndsbygget panel. Rutingbeslutninger tas nedstrøms av ordrelogistikk-pipelinen basert på hver biomarkørs koblinger per lab. Det resulterende settet valideres synkront mot kompletthetsreglene til hver lab. Noen biomarkører kan bare fås ved å bestille dem sammen med andre – en LDL/HDL-ratio leveres for eksempel av en bestilling som også returnerer LDL og HDL, så å be om ratioen alene gir ikke en sammenhengende bestilling. (Det er de samme komponentene ratioen prises etter – se pricing-oversikten i List opp biomarkører.) Når settet ikke kan bestilles komplett, returnerer kallet 400 med en validation-payload og ingenting lagres, så du kan prøve deg frem til et gyldig sett:
  1. PATCH … { "biomarker_ids": [45] } (LDL/HDL-ratio alene) → 400; validation.failures[].fix_options[].add_biomarkers lister opp LDL og HDL.
  2. PATCH … { "biomarker_ids": [45, 43, 42] } (ratio + LDL + HDL) → 200.
Den samme løkken dekker biomarkører som Aniva bare selger i en posisjon: ber du om én alene, returnerer kallet 400 med error: "biomarker_requires_position" og posisjonene som selger den. Se Prising. List opp biomarkører oppgir noen biomarkører som price_cents: null. Disse biomarkørene er ikke kuratert: Aniva har ikke priset dem. Hvis du legger til en slik, returnerer kallet 400 med error: "biomarker_not_priced". Ingen annen biomarkør løser denne feilen, fordi null betyr at du ikke har noen pris å kjøpe markøren for. Kit-markører er unntaket. Legg til panelet som er kittet, så følger medlemmene med panelet. Kallet godtar også et medlem du legger til på en time som allerede har det panelet. Ved kapillær blodprøvetaking (draw_method: capillary) pakkes blodprøvetakingen i mikrotainere. Paneler går først, i bestillingsrekkefølge. Individuelle biomarkører fyller deretter den ledige plassen i panelmikrotainerne. Når de trenger mer plass, åpner de nye mikrotainere. Vi fordeler dem jevnt. Hver mikrotainer rommer maksimalt 150 µl med individuelle biomarkører. En biomarkør som trenger mer enn 150 µl i sin egen mikrotainer, får aldri plass, og det gjør heller ikke en biomarkør uten kuratert volum. Hvis det resulterende settet bryter denne regelen, returnerer kallet 400 med en error-melding og ingenting lagres. Dette kallet er idempotent: biomarkører som allerede ligger på timen, beholdes. Krever scopene appointments_schedule og schedule_appointments_with_individual_biomarker_selection.
Biomarkører kan ikke legges til etter at du har kalt Bekreft blodprøvetaking. Forsøk på å endre en bekreftet time returnerer 409 Conflict.

Forespørsel

Stiparametere

string
påkrevd
Unik identifikator (UUID) for timen.

Body-parametere

number[]
påkrevd
Array med biomarkør-ID-er som skal legges til. Må inneholde minst ett element. Bruk List opp biomarkører for å finne ID-er.

Respons

Hvis kallet lykkes, returnerer API-et 200 OK som bekrefter at biomarkørene er lagt til.
boolean
true når biomarkørene er lagt til på timen.

Lese en 400

Hver kompletthetsvaliderings- og katalog-400 inneholder en setning i message. En body-validerings- eller mikrotainer-400 inneholder bare error. Forgren på error. Ved en kompletthetsvalideringsfeil er error en setning. Ved en katalogfeil er error en maskinkode: biomarker_not_priced eller biomarker_requires_position. Kompletthetsvalidering – settet kan ikke bestilles komplett hos noen lab:
  • validation.failures[] – finnes bare ved kompletthetsvalideringsfeil (mangler ved vanlige body-valideringsfeil). Én oppføring per biomarkørgruppe ingen lab kan levere, med biomarker_ids som feilet og fix_options[], med minste alternativ først. Hvert alternativs add_biomarkers ({ id, name }) er et sett du legger til ALLE fra – behold de opprinnelige, legg til disse og prøv igjen. En tom fix_options betyr at det ikke hjelper å legge til noe; fjern biomarkøren i stedet.
Biomarkør uten pris – Aniva har ikke priset denne biomarkøren. List opp biomarkører oppgir den som price_cents: null, eller utelater den når den er en ratio med en komponent uten pris. error er biomarker_not_priced, og biomarker_id angir markøren. Ingen annen biomarkør løser denne feilen, så fjern biomarkøren. To vilkår gjør en biomarkør bestillbar: En lab Aniva kan rute til må levere den, og Aniva-katalogen må prise den. Posisjonsbundet biomarkør – en biomarkør som bare selges i en posisjon, uten noen dekkende posisjon i settet. error er biomarker_requires_position, biomarker_id angir markøren, og positions[] lister opp hver posisjon som selger den, billigst først. Legg til alle biomarkørene i én av dem. Se Prising for modellen, og pricing.positions i Hent biomarkør for det fullstendige medlemssettet til en posisjon.

Feilresponser