Hopp til hovedinnhold
Bruk denne veiledningen for å finne et teststed, opprette en time for en pasientprofil og legge til testpanelene som skal kjøres. Fullfør disse stegene før pasienten kommer til blodprøvetaking.
1

Se tilgjengelige teststeder

Hent listen over tilgjengelige teststeder for kontoen din ved å sende en GET-forespørsel til /api/v1/locations.
Responsen er en array med stedsobjekter:
Bruk timezone-feltet fra stedsobjektet når du lager tidsstempelet for scheduled_at. Når du konverterer tidspunktet for timen til teststedets lokale tidssone, unngår du å bestille utenfor åpningstidene.
Ikke utled bestillbare tider fra open_hours alene. Kall Hent tilgjengelighet og bestill et starttidspunkt som returneres derfra – den oversikten tar også hensyn til eksisterende bestillinger, unntak for enkeltdatoer og minste forhåndsvarsel.
2

Opprett timen

Send en POST-forespørsel til /api/v1/appointments med profil-ID, steds-ID og ønsket tidspunkt for timen. Tidspunktet må være et starttidspunkt fra Hent tilgjengelighet.
scheduled_at må være et fremtidig tidspunkt i ISO 8601-format, for eksempel 2026-05-12T07:30:00Z. Tidsstempler i fortiden avvises med en 400-feil, og det samme gjelder tider innenfor minste forhåndsvarsel på 12 timer ved teststeder som drives av Aniva.
Det er trygt å sende denne forespørselen på nytt. En profil kan bare ha én time per sted og tidspunkt, så en opprettelse som sendes på nytt eller dobbelt returnerer 409 med den eksisterende appointment_id i stedet for å bestille pasienten to ganger.
En vellykket forespørsel returnerer 201 Created med timeobjektet:
Lagre id-en for timen – du trenger den for å legge til paneler og bekrefte blodprøvetakingen.
3

Legg til testpaneler

Legg til testpanelene som skal analyseres på blodprøven ved å sende en POST-forespørsel til /api/v1/appointments/{id}/panels.Panel-ID-er er UUID-er. Kall List opp paneler for å hente panelene API-nøkkelen din kan bestille.
Paneler kan ikke legges til etter at blodprøvetakingen er bekreftet. Legg til alle nødvendige paneler før bekreftelse – se Bekreft blodprøvetaking for detaljer.
En vellykket forespørsel returnerer 200 OK som bekrefter at panelene er lagt til:

Flytte eller avbestille

Etter at du har opprettet en time, kan du fortsatt endre den før blodprøvetakingen er bekreftet:
  • Flytt tidspunkt eller endre sted – Send en PATCH-forespørsel til /api/v1/appointments/{id} med feltene som skal oppdateres. Se Oppdater time.
  • Avbestill – Send en DELETE-forespørsel til /api/v1/appointments/{id}. Se Avbestill time.
Begge operasjonene er bare tilgjengelige før blodprøvetakingen – det vil si mens timen har statusen pending eller confirmed. Når timen går over til blood_drawn, er det ikke lenger mulig å gjøre endringer.

Feilhåndtering