Przejdź do głównej treści
GET
Pobierz kliniczne i genetyczne wyniki laboratoryjne dla wizyty wraz z odwołaniami do dokumentów PDF raportów laboratoryjnych. Każdy biomarker zlecony na wizytę pojawia się w odpowiedzi, dzięki czemu możesz śledzić całe zlecenie, a nie tylko to, co już wróciło. Przed użyciem pola value sprawdź status każdego wyniku:
  • Badania nadal oczekujące mają status planned, dopóki wizyta ma status in_progress.
  • Wyniki dostarczone przez laboratorium, których nie wolno używać klinicznie, mają status fault lub undeliverable oraz pole status_reason wyjaśniające powód. Wynik ze statusem fault nadal ma wypełnione pole value — ta wartość jest błędna. Nigdy nie pokazuj jej jako wyniku.
  • Wyniki budzące wątpliwości Aniva lub użytkownika mają status likely_wrong i pole status_reason. Wartość nie jest potwierdzona. Nie pokazuj jej jako wyniku bez weryfikacji.
Każdy otrzymany wynik i dokument zawiera pole lab_code (kod kreskowy probówki), pod którym został zarejestrowany, a tablica submissions wymienia każde zlecenie laboratoryjne z tego pobrania krwi wraz z jego własnym statusem — pobranie krwi obejmujące kilka probówek lub laboratoriów kończy się zlecenie po zleceniu. Użyj Pobierz dokument, aby pobrać pliki PDF raportów laboratoryjnych wskazane w tablicy documents. Nie musisz odpytywać tego endpointu cyklicznie. Zasubskrybuj webhooki appointment.results.updated lub appointment.results.completed i wywołaj go, gdy dotrze zdarzenie. Cykliczne odpytywanie nadal działa jako rozwiązanie zapasowe. Wymaga zakresu results_view.

Żądanie

Parametry ścieżki

string
wymagane
Unikalny identyfikator (UUID) wizyty, dla której chcesz pobrać wyniki.

Odpowiedź

W razie powodzenia API zwraca 200 OK wraz z obiektem wyników.
string
wymagane
Ogólny status wyników. Jedna z wartości:
  • in_progress — część zleceń jest jeszcze w laboratorium.
  • completed — wszystkie zlecenia zostały zamknięte i co najmniej jedno zwróciło wyniki.
  • fault — wszystkie zlecenia zakończyły się błędem bez raportu. Nie ma już nic zaległego.
object[]
wymagane
Jeden wpis na każde zlecenie laboratoryjne — pobranie krwi obejmujące kilka probówek lub laboratoriów ma ich kilka. Nadrzędny status ma wartość completed, gdy każdy wpis został zamknięty i jeden zwrócił raport.
object[]
wymagane
Tablica klinicznych wyników biomarkerów.
object[]
wymagane
Tablica genetycznych wyników biomarkerów.
object[]
wymagane
Dokumenty raportów laboratoryjnych. Użyj GET /api/v1/documents/{id}, aby pobrać każdy plik.

Powtarzane wywołania

Aniva przechowuje odpowiedź tego punktu końcowego przez 60 minut dla każdego klucza API. Ponowne wywołanie w tym czasie zwraca zapisaną odpowiedź, dopóki wizyta i jej wyniki pozostają bez zmian. Po zmianie otrzymujesz świeżą odpowiedź. Nagłówki Cache-Status i Age pokazują, że odpowiedź jest zapisana i jaki jest jej wiek. Aby dowiedzieć się o zmianie od razu, zasubskrybuj zdarzenia webhooka appointment.results.updated, appointment.results.completed i appointment.results.fault. Zobacz Powtarzane odczyty.

Odpowiedzi z błędami