Přejít na hlavní obsah
GET
Načti klinické a genetické laboratorní výsledky pro termín spolu s odkazy na dokumenty PDF laboratorních zpráv. Každý biomarker objednaný k termínu se objeví v odpovědi, takže můžeš sledovat celou objednávku, ne jen to, co už dorazilo. Než použiješ value, zkontroluj status u každého výsledku:
  • Testy, na které se ještě čeká, mají stav planned, dokud je termín ve stavu in_progress.
  • Výsledky, které laboratoř dodala, ale které se nesmí klinicky použít, mají stav fault nebo undeliverable a obsahují status_reason s vysvětlením proč. Výsledek ve stavu fault má stále vyplněné value — tato hodnota je chybná. Nikdy ji neuváděj jako nález.
  • Výsledky, o kterých Aniva nebo člen pochybuje, mají stav likely_wrong a status_reason. Hodnota není potvrzená. Bez kontroly ji nezobrazuj jako nález.
Každý přijatý výsledek a dokument obsahuje lab_code (čárový kód zkumavky), pod kterým byl evidován, a pole submissions uvádí každou laboratorní žádanku odběru krve s vlastním stavem — odběr rozdělený do více zkumavek nebo laboratoří se dokončuje po jednotlivých žádankách. Ke stažení PDF laboratorních zpráv uvedených v poli documents použij Stáhnout dokument. Tento endpoint nemusíš opakovaně dotazovat. Přihlas se k odběru webhooků appointment.results.updated nebo appointment.results.completed a zavolej ho, až dorazí událost. Opakované dotazování stále funguje jako záloha. Vyžaduje scope results_view.

Požadavek

Parametry cesty

string
povinné
Jedinečný identifikátor (UUID) termínu, pro který chceš načíst výsledky.

Odpověď

Při úspěchu vrátí API 200 OK s objektem výsledků.
string
povinné
Celkový stav výsledků. Jedna z hodnot:
  • in_progress — některé žádanky jsou stále v laboratoři.
  • completed — všechny žádanky jsou uzavřené a alespoň jedna dodala výsledky.
  • fault — všechny žádanky skončily bez výsledků. Nic dalšího už nepřijde.
object[]
povinné
Jeden záznam na každou laboratorní žádanku — odběr krve rozdělený do více zkumavek nebo laboratoří jich má několik. Hlavní status je completed, jakmile jsou všechny záznamy uzavřené a alespoň jeden dodal výsledky.
object[]
povinné
Pole klinických výsledků biomarkerů.
object[]
povinné
Pole genetických výsledků biomarkerů.
object[]
povinné
Dokumenty laboratorních zpráv. Jednotlivé soubory stáhneš pomocí GET /api/v1/documents/{id}.

Opakovaná volání

Aniva ukládá odpověď tohoto endpointu po dobu 60 minut pro každý API klíč. Opakované volání v tomto čase dostane uloženou odpověď, dokud se termín a jeho výsledky nezmění. Po změně dostaneš čerstvou odpověď. Hlavičky Cache-Status a Age ukazují, že je odpověď uložená a jak je stará. Pokud se chceš o změně dozvědět hned, přihlas se k odběru událostí webhooku appointment.results.updated, appointment.results.completed a appointment.results.fault. Viz Opakované čtení.

Chybové odpovědi