Vai al contenuto principale
GET
Recupera i risultati di laboratorio clinici e genetici di un appuntamento, insieme ai riferimenti ai documenti per i PDF dei referti di laboratorio. Ogni biomarcatore ordinato per l’appuntamento compare nella risposta, così puoi seguire l’intero ordine e non solo i risultati già arrivati. Leggi status su ogni risultato prima di usare il suo value:
  • Gli esami ancora in attesa compaiono con stato planned mentre l’appuntamento è in_progress.
  • I risultati consegnati dal laboratorio ma che non devono essere usati clinicamente compaiono con stato fault o undeliverable e includono un status_reason che spiega il motivo. Un risultato fault ha comunque il campo value popolato — quel valore è errato. Non presentarlo mai come un dato clinico.
  • I risultati messi in dubbio da Aniva o dal membro compaiono con stato likely_wrong e un status_reason. Il valore non è confermato. Non mostrarlo come un dato clinico senza una verifica.
Ogni risultato e documento ricevuto riporta il lab_code (codice a barre della provetta) con cui è stato registrato, e l’array submissions elenca ogni richiesta di laboratorio del prelievo di sangue con il proprio stato — un prelievo di sangue su più provette o laboratori si completa richiesta dopo richiesta. Usa Scarica documento per scaricare i PDF dei referti di laboratorio referenziati nell’array documents. Non serve interrogare periodicamente questo endpoint. Iscriviti ai webhook appointment.results.updated o appointment.results.completed e chiamalo quando arriva un evento. Il polling funziona comunque come alternativa. Richiede lo scope results_view.

Richiesta

Parametri di percorso

string
obbligatorio
Identificatore univoco (UUID) dell’appuntamento di cui recuperare i risultati.

Risposta

In caso di successo, l’API restituisce 200 OK con l’oggetto dei risultati.
string
obbligatorio
Stato complessivo dei risultati. Uno tra:
  • in_progress — alcune richieste sono ancora in laboratorio.
  • completed — ogni richiesta si è chiusa e almeno una ha prodotto un referto.
  • fault — ogni richiesta è fallita senza produrre un referto. Non è dovuto nulla.
object[]
obbligatorio
Una voce per ogni richiesta di laboratorio — un prelievo di sangue su più provette o laboratori ne ha diverse. Lo status di primo livello è completed quando ogni voce si è chiusa e una ha prodotto un referto.
object[]
obbligatorio
Array di risultati di biomarcatori clinici.
object[]
obbligatorio
Array di risultati di biomarcatori genetici.
object[]
obbligatorio
Documenti dei referti di laboratorio. Usa GET /api/v1/documents/{id} per scaricare ogni file.

Chiamate ripetute

Aniva salva la risposta di questo endpoint per 60 minuti per ogni chiave API. Una chiamata ripetuta in questo intervallo riceve la risposta salvata finché l’appuntamento e i suoi risultati non cambiano. Dopo una modifica, ricevi una risposta aggiornata. Gli header Cache-Status e Age indicano che la risposta è salvata e da quanto tempo. Per sapere subito di una modifica, iscriviti agli eventi webhook appointment.results.updated, appointment.results.completed e appointment.results.fault. Vedi Letture ripetute.

Risposte di errore