Hoppa till huvudinnehåll
Aniva Partner API är ett REST-API som låter vårdpartner hantera patientprofiler, boka blodprovstagningar på provtagningsplatser och starta labbeställningsflöden. Du kommunicerar med API:et över HTTPS med din partner-API-nyckel.

Vad du kan göra

  • Profilhantering — Skapa, hämta och uppdatera patientprofiler med demografiska uppgifter.
  • Tidsbokning — Boka blodprovstagningar på Anivas provtagningsplatser.
  • Panelhantering — Lägg till eller ta bort labbtestpaneler på en befintlig bokning.
  • Enskilda biomarkörer — Lägg till eller ta bort enskilda biomarkörer på en bokning utan att välja en panel.
  • Beställningar av hemtestkit — Skicka ett hemtestkit per post till en patient, spåra paketen och rapportera när provet togs.
  • Panelkatalog — Bläddra bland tillgängliga paneler med GET /api/v1/panels för att hitta panel-ID:n och vilka biomarkörer som ingår.
  • Biomarkörkatalog — Bläddra bland biomarkörerna du kan beställa på en provtagningsplats eller i ett hemtestkit med GET /api/v1/biomarkers för att hitta ID:n.
  • Bekräftelse av blodprovstagning — Skicka in labbkod(er) efter en blodprovstagning för att starta labbeställningsflödet.
  • Labbresultat — Hämta kliniska och genetiska resultat och ladda ner labbrapporter som PDF.
  • Provtagningsplatser — Lista tillgängliga provtagningsplatser att visa för patienter.
  • Fraktlogistik — Skapa, spåra, ändra och avboka budförsändelser.
  • Webhooks — Få ett HTTPS-anrop när en bokning, en beställning av hemtestkit, dess resultat, en provtagningsplats, en profil eller en försändelse ändras. Se Webhooks.

Utforska dokumentationen

Autentisering

Autentisera anrop med din partner-API-nyckel.

Snabbstart

Gör ditt första API-anrop på några minuter med steg-för-steg-exempel.

Profiler

Lär dig hur patientprofiler fungerar och vilken data de innehåller.

Bokningar

Förstå bokningens livscykel från tidsbokning till bekräftelse.

Beställningar av hemtestkit

Skicka ett testkit hem till en patient och följ det tills provet når labbet.

API-versionering

Den aktuella API-versionen är v1. Alla slutpunkter inleds med /api/v1/. Bas-URL:en är https://anivahealth.com.
Brytande ändringar införs under ett nytt versionsprefix. v1-API:et fortsätter att vara tillgängligt och eventuella utfasningar meddelas i förväg.

Datum och tidszoner

Alla tidpunkter som överförs är UTC ISO 8601 (Z-suffix). Rena kalenderfält använder datum och klockslag (YYYY-MM-DD, HH:MM). Särskilda anmärkningar:
  • Indata som tar datum och tid (t.ex. scheduled_at på POST / PATCH /api/v1/appointments) måste innehålla en tidszonsangivelse — antingen Z eller en explicit tidsförskjutning som +02:00. Naiva datum- och tidsvärden avvisas med 400. Båda formerna anger samma tidpunkt; svaret returnerar alltid scheduled_at som UTC Z. Använd provtagningsplatsens timezone-fält (eller en annan IANA-identifierare) för att formatera tidpunkten i lokal tid vid visning.
  • Indata med datum och klockslag tolkas i den berörda resursens tidszon: datum för tillgänglighet använder frågeparametern timezone (standard är provtagningsplatsens tidszon); försändelsens pickup_date / pickup_time_* tolkas i ursprungsplatsens tidszon.
  • Svarsfält med enbart datum (t.ex. tested_at, tillgänglighetens availability[].date) är kalenderdatum utan tidszon.

Få åtkomst

API-nycklar utfärdas per partner av Aniva.
Kontakta Aniva för att få din partner-API-nyckel.