Hoppa till huvudinnehåll
Använd den här guiden för att hitta en provtagningsplats, skapa en bokning för en patientprofil och lägga till de testpaneler som ska analyseras. Gör klart dessa steg innan patienten kommer till sin blodprovstagning.
1

Bläddra bland tillgängliga platser

Hämta listan över provtagningsplatser som är tillgängliga på ditt konto genom att skicka en GET-förfrågan till /api/v1/locations.
Svaret är en array med platsobjekt:
Använd fältet timezone från platsobjektet när du skapar tidsstämpeln scheduled_at. Genom att konvertera bokningstiden till platsens lokala tidszon undviker du att boka utanför öppettiderna.
Härled inte bokningsbara tider enbart från open_hours. Anropa Hämta tillgänglighet och boka en starttid som returneras därifrån – den tar även hänsyn till befintliga bokningar, undantag för enskilda datum och minsta framförhållning.
2

Skapa bokningen

Skicka en POST-förfrågan till /api/v1/appointments med profil-ID, plats-ID och önskad bokningstid. Tiden måste vara en starttid från Hämta tillgänglighet.
scheduled_at måste vara en framtida tidpunkt i ISO 8601-format, till exempel 2026-05-12T07:30:00Z. Tidsstämplar i det förflutna avvisas med ett 400-fel, liksom tider inom minsta framförhållning på 12 timmar på platser som drivs av Aniva.
Det är säkert att upprepa den här förfrågan. En profil kan bara ha en bokning per plats och tid, så en förfrågan som skickas igen eller dubbelt returnerar 409 med befintligt appointment_id i stället för att boka patienten två gånger.
En lyckad förfrågan returnerar 201 Created med bokningsobjektet:
Spara bokningens id – du behöver det för att lägga till paneler och bekräfta blodprovstagningen.
3

Lägg till testpaneler

Lägg till de testpaneler som ska analyseras på blodprovet genom att skicka en POST-förfrågan till /api/v1/appointments/{id}/panels.Panel-ID:n är UUID:er. Anropa Lista paneler för att hämta de paneler din API-nyckel kan beställa.
Paneler kan inte läggas till efter att blodprovstagningen har bekräftats. Lägg till alla nödvändiga paneler före bekräftelsen – se Bekräfta blodprovstagning för mer information.
En lyckad förfrågan returnerar 200 OK och bekräftar att panelerna har lagts till:

Boka om eller avboka

När du har skapat en bokning kan du fortfarande ändra den innan blodprovstagningen bekräftas:
  • Boka om eller byt plats – Skicka en PATCH-förfrågan till /api/v1/appointments/{id} med de fält som ska uppdateras. Se Uppdatera bokning.
  • Avboka – Skicka en DELETE-förfrågan till /api/v1/appointments/{id}. Se Avboka bokning.
Båda åtgärderna är bara tillgängliga före blodprovstagningen – det vill säga medan bokningen har statusen pending eller confirmed. När bokningen har ändrats till blood_drawn går det inte längre att göra några ändringar.

Felhantering