Siirry pääsisältöön
GET
Hae ajanvarauksen kliiniset ja geneettiset laboratoriotulokset sekä asiakirjaviitteet laboratorioraporttien PDF-tiedostoihin. Jokainen ajanvaraukselle tilattu biomarkkeri näkyy vastauksessa, jotta voit seurata koko tilausta pelkkien saapuneiden tulosten sijaan. Tarkista jokaisen tuloksen status ennen sen value-arvon käyttöä:
  • Vielä valmistumattomat testit näkyvät tilassa planned, kun ajanvaraus on tilassa in_progress.
  • Laboratorion toimittamat tulokset, joita ei saa käyttää kliinisesti, näkyvät tilassa fault tai undeliverable, ja niissä on syyn selittävä status_reason. Tilassa fault olevassa tuloksessa on yhä value-arvo – se arvo on virheellinen. Älä koskaan esitä sitä löydöksenä.
  • Tulokset, joita Aniva tai jäsen epäilee, näkyvät tilassa likely_wrong ja sisältävät kentän status_reason. Arvoa ei ole vahvistettu. Älä näytä sitä löydöksenä ilman tarkistusta.
Jokaisessa saapuneessa tuloksessa ja asiakirjassa on lab_code (putken viivakoodi), jolla se on kirjattu, ja submissions-taulukko listaa jokaisen verinäytteenoton laboratoriolähetteen omine tiloineen – usean putken tai laboratorion verinäytteenotto valmistuu lähete kerrallaan. Lataa documents-taulukossa viitatut laboratorioraporttien PDF-tiedostot päätepisteellä Lataa asiakirja. Sinun ei tarvitse kysellä tätä päätepistettä toistuvasti. Tilaa appointment.results.updated- tai appointment.results.completed-webhookit ja kutsu päätepistettä, kun tapahtuma saapuu. Toistuva kysely toimii yhä varavaihtoehtona. Vaatii results_view-käyttöoikeuden.

Pyyntö

Polkuparametrit

string
vaadittu
Sen ajanvarauksen yksilöllinen tunniste (UUID), jonka tulokset haetaan.

Vastaus

Onnistuessaan API palauttaa 200 OK ja tulokset sisältävän objektin.
string
vaadittu
Tulosten kokonaistila. Yksi seuraavista:
  • in_progress – osa lähetteistä on yhä laboratoriossa.
  • completed – kaikki lähetteet ovat sulkeutuneet ja ainakin yksi raportoi tulokset.
  • fault – kaikki lähetteet päättyivät ilman tuloksia. Mitään ei ole enää tulossa.
object[]
vaadittu
Yksi merkintä kutakin laboratoriolähetettä kohti – useaa putkea tai laboratoriota koskevalla verinäytteenotolla on useita. Ylätason status on completed, kun jokainen merkintä on sulkeutunut ja vähintään yksi on raportoinut.
object[]
vaadittu
Taulukko kliinisistä biomarkkerituloksista.
object[]
vaadittu
Taulukko geneettisistä biomarkkerituloksista.
object[]
vaadittu
Laboratorioraporttien asiakirjat. Lataa kukin tiedosto kutsulla GET /api/v1/documents/{id}.

Toistuvat kutsut

Aniva tallentaa tämän päätepisteen vastauksen 60 minuutiksi kullekin API-avaimelle. Tämän ajan sisällä tehty toistuva kutsu saa tallennetun vastauksen, kun ajanvaraus ja sen tulokset pysyvät muuttumattomina. Muutoksen jälkeen saat tuoreen vastauksen. Otsikot Cache-Status ja Age kertovat, että vastaus on tallennettu ja kuinka vanha se on. Jos haluat tiedon muutoksesta heti, tilaa webhook-tapahtumat appointment.results.updated, appointment.results.completed ja appointment.results.fault. Katso Toistuvat lukukutsut.

Virhevastaukset