Ugrás a fő tartalomhoz
Ezzel az útmutatóval megkereshetsz egy vizsgálati helyszínt, időpontot hozhatsz létre egy páciensprofilhoz, és hozzárendelheted az elvégzendő tesztpaneleket. Végezd el ezeket a lépéseket, mielőtt a páciens megérkezik a vérvételre.
1

Elérhető helyszínek böngészése

Kérd le a fiókodban elérhető vizsgálati helyszínek listáját egy GET kéréssel a /api/v1/locations végpontra.
A válasz helyszínobjektumok tömbje:
A scheduled_at időbélyeg összeállításakor használd a helyszínobjektum timezone mezőjét. Ha az időpontot a helyszín helyi időzónájára váltod át, elkerülheted, hogy nyitvatartási időn kívülre foglalj.
Ne csak az open_hours alapján határozd meg a foglalható időpontokat. Hívd meg az Elérhetőség lekérése végpontot, és az általa visszaadott idősávok egyikének kezdetére foglalj — ez az idősávrács a meglévő foglalásokat, a dátumhoz kötött kivételeket és a minimális előzetes foglalási időt is figyelembe veszi.
2

Időpont létrehozása

Küldj egy POST kérést a /api/v1/appointments végpontra a profilazonosítóval, a helyszínazonosítóval és a kívánt időponttal. Az időpontnak az Elérhetőség lekérése végpont által visszaadott egyik idősáv kezdetének kell lennie.
A scheduled_at értékének jövőbeli, ISO 8601 formátumú dátumnak és időpontnak kell lennie, például 2026-05-12T07:30:00Z. A múltbeli időbélyegeket a rendszer 400-as hibával elutasítja, ahogy az Aniva által üzemeltetett helyszíneken a 12 órás minimális előzetes foglalási időn belüli időpontokat is.
Ennek a kérésnek az ismétlése biztonságos. Egy profilnak helyszínenként és időpontonként csak egy időpontja lehet, így egy újraküldött vagy duplán beküldött létrehozási kérés a páciens kétszeri lefoglalása helyett 409-es választ ad vissza a meglévő appointment_id értékkel.
Sikeres kérés esetén a válasz 201 Created az időpontobjektummal:
Mentsd el az időpont id értékét — szükséged lesz rá a panelek hozzáadásához és a vérvétel megerősítéséhez.
3

Tesztpanelek hozzáadása

Rendeld hozzá a vérmintán elvégezni kívánt tesztpaneleket egy POST kéréssel a /api/v1/appointments/{id}/panels végpontra.A panelazonosítók UUID-k. Hívd meg a Panelek listázása végpontot, hogy lekérd az API-kulcsoddal rendelhető paneleket.
A vérvétel megerősítése után már nem adhatók hozzá panelek. Minden szükséges panelt a megerősítés előtt adj hozzá — részletekért lásd a Vérvétel megerősítése útmutatót.
Sikeres kérés esetén a válasz 200 OK, amely megerősíti a panelek hozzáadását:

Átütemezés vagy lemondás

Az időpont létrehozása után a vérvétel megerősítéséig még módosíthatod azt:
  • Átütemezés vagy helyszínmódosítás — Küldj egy PATCH kérést a /api/v1/appointments/{id} végpontra a frissítendő mezőkkel. Lásd: Időpont frissítése.
  • Lemondás — Küldj egy DELETE kérést a /api/v1/appointments/{id} végpontra. Lásd: Időpont lemondása.
Mindkét művelet csak a vérvétel előtt érhető el — vagyis amíg az időpont pending vagy confirmed státuszban van. Amint az időpont blood_drawn státuszba kerül, további módosítás nem lehetséges.

Hibakezelés