Přejít na hlavní obsah
Podle tohoto průvodce najdeš testovací místo, vytvoříš termín pro profil pacienta a připojíš testovací panely k vyšetření. Tyto kroky dokonči ještě předtím, než pacient dorazí na odběr krve.
1

Projdi si dostupná místa

Seznam testovacích míst dostupných pro tvůj účet získáš odesláním požadavku GET na /api/v1/locations.
Odpověď je pole objektů míst:
Při sestavování časového razítka scheduled_at použij pole timezone z objektu místa. Převod času termínu do místního časového pásma ti pomůže vyhnout se plánování mimo otevírací dobu.
Neodvozuj dostupné časy jen z pole open_hours. Zavolej Získat dostupnost a rezervuj začátek slotu, který vrátí — tato mřížka zohledňuje i existující rezervace, výjimky pro konkrétní data a minimální předstih.
2

Vytvoř termín

Pošli požadavek POST na /api/v1/appointments s ID profilu, ID místa a požadovaným časem termínu. Čas musí být začátek slotu z Získat dostupnost.
scheduled_at musí být budoucí datum a čas ve formátu ISO 8601, například 2026-05-12T07:30:00Z. Časová razítka v minulosti jsou zamítnuta chybou 400, stejně jako časy spadající do 12hodinového minimálního předstihu na místech, která provozuje Aniva.
Opakování tohoto požadavku je bezpečné. Profil může mít pro dané místo a čas jen jeden termín, takže opakovaně nebo dvakrát odeslaný požadavek vrátí 409 s existujícím appointment_id místo dvojí rezervace pacienta.
Úspěšný požadavek vrátí 201 Created s objektem termínu:
Ulož si id termínu — budeš ho potřebovat k přidání panelů a potvrzení odběru krve.
3

Přidej testovací panely

Odesláním požadavku POST na /api/v1/appointments/{id}/panels připoj testovací panely, které chceš ze vzorku krve vyšetřit.ID panelů jsou UUID. Zavolej Vypsat panely a získej panely, které může tvůj API klíč objednat.
Po potvrzení odběru krve už panely nelze přidat. Všechny potřebné panely přidej před potvrzením — podrobnosti viz Potvrdit odběr krve.
Úspěšný požadavek vrátí 200 OK s potvrzením, že panely byly přidány:

Přeplánování nebo zrušení

Po vytvoření můžeš termín ještě upravit, dokud není odběr krve potvrzený:
  • Přeplánování nebo změna místa — Pošli požadavek PATCH na /api/v1/appointments/{id} s poli, která chceš upravit. Viz Upravit termín.
  • Zrušení — Pošli požadavek DELETE na /api/v1/appointments/{id}. Viz Zrušit termín.
Obě operace jsou dostupné jen před odběrem krve — tedy dokud je termín ve stavu pending nebo confirmed. Jakmile termín přejde do stavu blood_drawn, další úpravy už nejsou možné.

Zpracování chyb