Siirry pääsisältöön
Tämän oppaan avulla löydät testauspaikan, luot ajanvarauksen potilasprofiilille ja liität siihen tehtävät testipaneelit. Tee nämä vaiheet ennen kuin potilas saapuu verinäytteenottoon.
1

Selaa saatavilla olevia paikkoja

Hae tilillesi saatavilla olevien testauspaikkojen luettelo lähettämällä GET-pyyntö osoitteeseen /api/v1/locations.
Vastaus on taulukko paikkaobjekteja:
Käytä paikkaobjektin timezone-kenttää, kun muodostat scheduled_at-aikaleiman. Ajanvarausajan muuntaminen paikan paikalliseen aikavyöhykkeeseen auttaa välttämään varaamista aukioloaikojen ulkopuolelle.
Älä päättele varattavia aikoja pelkästään open_hours-kentästä. Kutsu päätepistettä Hae saatavuus ja varaa sen palauttama aikavälin alkamisaika — kyseinen aikataulu huomioi myös olemassa olevat varaukset, päiväkohtaiset poikkeukset ja vähimmäisvaroajan.
2

Luo ajanvaraus

Lähetä POST-pyyntö osoitteeseen /api/v1/appointments ja sisällytä siihen profiilin tunnus, paikan tunnus sekä haluamasi ajanvarausaika. Ajan on oltava päätepisteestä Hae saatavuus saatu aikavälin alkamisaika.
scheduled_at-arvon on oltava tuleva päivämäärä ja kellonaika ISO 8601 -muodossa, esimerkiksi 2026-05-12T07:30:00Z. Menneisyydessä olevat aikaleimat hylätään 400-virheellä, samoin kuin ajat, jotka jäävät Anivan operoimien paikkojen 12 tunnin vähimmäisvaroajan sisään.
Tämän pyynnön toistaminen on turvallista. Profiililla voi olla vain yksi ajanvaraus paikkaa ja ajankohtaa kohden, joten uudelleen tai kahdesti lähetetty luontipyyntö palauttaa tilakoodin 409 ja olemassa olevan appointment_id-tunnuksen sen sijaan, että potilaalle varattaisiin kaksi aikaa.
Onnistunut pyyntö palauttaa tilakoodin 201 Created ja ajanvarausobjektin:
Tallenna ajanvarauksen id — tarvitset sitä paneelien lisäämiseen ja verinäytteenoton vahvistamiseen.
3

Lisää testipaneelit

Liitä verinäytteestä tutkittavat testipaneelit lähettämällä POST-pyyntö osoitteeseen /api/v1/appointments/{id}/panels.Paneelitunnukset ovat UUID-tunnuksia. Kutsu päätepistettä Listaa paneelit saadaksesi paneelit, jotka API-avaimesi voi tilata.
Paneeleja ei voi lisätä verinäytteenoton vahvistamisen jälkeen. Lisää kaikki tarvittavat paneelit ennen vahvistusta — katso lisätiedot oppaasta Vahvista verinäytteenotto.
Onnistunut pyyntö palauttaa tilakoodin 200 OK, mikä vahvistaa paneelien lisäämisen:

Ajan muuttaminen tai peruuttaminen

Ajanvarauksen luomisen jälkeen voit vielä muokata sitä ennen verinäytteenoton vahvistamista:
  • Muuta aikaa tai paikkaa — Lähetä PATCH-pyyntö osoitteeseen /api/v1/appointments/{id} ja sisällytä päivitettävät kentät. Katso Päivitä ajanvaraus.
  • Peruuta — Lähetä DELETE-pyyntö osoitteeseen /api/v1/appointments/{id}. Katso Peruuta ajanvaraus.
Molemmat toiminnot ovat käytettävissä vain ennen verinäytteenottoa — eli kun ajanvarauksen tila on pending tai confirmed. Kun ajanvaraus siirtyy tilaan blood_drawn, sitä ei voi enää muokata.

Virheenkäsittely