Siirry pääsisältöön
GET
Hae yksittäinen verinäytteenoton ajanvaraus sen UUID-tunnisteella, mukaan lukien sisällytetty potilasprofiili. Käytä tätä päätepistettä ajanvarauksen tilan tarkistamiseen, aikataulutietojen vahvistamiseen tai liitettyjen profiilitietojen hakemiseen. Vaatii appointments_view- tai appointments_schedule-käyttöoikeuden.

Pyyntö

Polkuparametrit

string
vaadittu
Haettavan ajanvarauksen yksilöllinen tunniste (UUID).

Vastaus

Onnistuessaan API palauttaa 200 OK sekä ajanvarauksen ja siihen sisällytetyn profiilin.
string
vaadittu
Ajanvarauksen yksilöllinen tunniste (UUID).
string
vaadittu
Sen profiilin UUID, johon tämä ajanvaraus kuuluu.
string
Sen testipaikan UUID, jossa verinäytteenotto tehdään.
string
Ajanvarauksen sovittu päivämäärä ja aika UTC-hetkenä (ISO 8601 ja Z-pääte, esim. 2026-05-15T10:30:00Z). Voi olla null.
string
vaadittu
Ajanvarauksen nykyinen tila. Jokin arvoista pending, confirmed, blood_drawn tai cancelled. Laboratoriotulosten tarkempi valmistumistila saadaan kutsusta Hae tulokset; lähetyksen tarkempi eteneminen kunkin shipments-taulukon alkion (katso alla) kautta kutsusta Hae lähetys.
string
Vapaamuotoinen syy, joka kirjattiin ajanvarauksen perumisen yhteydessä (esim. saapumatta jääminen, myöhäinen peruminen, “Epäonnistui. Uusinta tarvitaan”). null, ellei status ole cancelled.
string[]
vaadittu
Osoitteet pienillä kirjaimilla, joista jokainen saa yhden sähköpostin kaikkien laboratoriotulosten valmistuttua. Tyhjä, kun toiminto on pois päältä. Katso Tulokset valmiit -sähköpostit.
string
vaadittu
Verinäytteenottotapa: capillary (sormenpäästä tai olkavarresta mikroputkiin) tai venous (laskimosta putkiin). Se on ajanvaraukselle asetettu tapa tai muutoin sen toimipisteen default_draw_method. Verinäytteenoton jälkeen se on käytetty tapa.
string
vaadittu
ISO 8601 -aikaleima ajanvarauksen luontihetkestä.
string
ISO 8601 -aikaleima viimeisimmästä päivityksestä. Voi olla null.
object
vaadittu
Tähän ajanvaraukseen liitetty potilasprofiili.
AppointmentPanel[]
vaadittu
Tähän ajanvaraukseen tällä hetkellä liitetyt paneelit. Ei sisällä peruttuja liitoksia. Katso paneelin tiedot (nimi, biomarkkerit) päätepisteestä Listaa paneelit.
AppointmentIndividualBiomarker[]
vaadittu
Yksittäiset biomarkkerit, jotka on liitetty tähän ajanvaraukseen paneelien ulkopuolelta (katso Lisää yksittäisiä biomarkkereita). Hae kunkin biomarker_id-arvon näyttötiedot kutsulla Listaa biomarkkerit.
AppointmentShipmentLink[]
vaadittu
Tähän ajanvaraukseen liitetyt lähetykset vanhimmasta liitoksesta alkaen. Tyhjä taulukko, kun lähetyksiä ei ole liitetty. Hae kunkin id-arvon täydet lähetystiedot (tila, seurantanumero, tilapäivitykset jne.) päätepisteestä Hae lähetys.
string[]
vaadittu
Tälle ajanvaraukselle kirjatut laboratoriokoodit (putkien viivakoodit) skannausjärjestyksessä. Tyhjä, kunnes verinäytteenotto on vahvistettu. Laskimonäytteenotossa on yksi koodi painettuna jokaiseen putkeen, kapillaarinäytteenotossa taas yksi koodi mikroputkea kohti. Kutsun Hae tulokset tulokset ja asiakirjat viittaavat näihin koodeihin kentällä lab_code.

Toistuvat kutsut

Aniva tallentaa tämän päätepisteen vastauksen 15 minuutiksi kullekin API-avaimelle. Tämän ajan sisällä tehty toistuva kutsu saa tallennetun vastauksen, jos ajanvaraus ei ole muuttunut. Muutoksen jälkeen saat tuoreen vastauksen. Otsikot Cache-Status ja Age osoittavat, että vastaus on tallennettu ja kuinka vanha se on. Jos haluat tiedon muutoksesta heti, tilaa webhook-tapahtumat appointment.created, appointment.rescheduled sekä kunkin tilan tapahtuma, esimerkiksi appointment.confirmed. Katso Toistuvat haut.

Virhevastaukset