Passer au contenu principal
GET
Récupère les résultats de laboratoire cliniques et génétiques d’un rendez-vous, ainsi que les références de documents pour les rapports de laboratoire en PDF. Chaque biomarqueur commandé pour le rendez-vous apparaît dans la réponse, ce qui te permet de suivre toute la commande et pas seulement ce qui est revenu. Lis status sur chaque résultat avant d’utiliser sa value :
  • Les analyses toujours en attente apparaissent avec le statut planned tant que le rendez-vous est in_progress.
  • Les résultats fournis par le laboratoire mais qui ne doivent pas être utilisés cliniquement apparaissent avec le statut fault ou undeliverable, et comportent un status_reason expliquant pourquoi. Un résultat fault a toujours sa value renseignée — cette valeur est erronée. Ne la présente jamais comme un résultat.
  • Les résultats dont Aniva ou le membre doute apparaissent avec le statut likely_wrong et un status_reason. La valeur n’est pas confirmée. Ne l’affiche pas comme un résultat sans vérification.
Chaque résultat et document reçu porte le lab_code (code-barres du tube) sous lequel il a été enregistré, et le tableau submissions liste chaque demande d’analyse de la prise de sang avec son propre statut — une prise de sang répartie sur plusieurs tubes ou laboratoires se complète demande par demande. Utilise Télécharger un document pour télécharger les rapports de laboratoire en PDF référencés dans le tableau documents. Tu n’as pas besoin d’interroger régulièrement ce point de terminaison. Abonne-toi aux webhooks appointment.results.updated ou appointment.results.completed, et appelle-le lorsqu’un événement arrive. L’interrogation régulière reste possible en solution de secours. Nécessite le scope results_view.

Requête

Paramètres de chemin

string
requis
Identifiant unique (UUID) du rendez-vous pour lequel récupérer les résultats.

Réponse

En cas de succès, l’API renvoie 200 OK avec l’objet des résultats.
string
requis
Statut global des résultats. L’une des valeurs suivantes :
  • in_progress — certaines demandes sont encore au laboratoire.
  • completed — toutes les demandes sont clôturées et au moins une a rendu ses résultats.
  • fault — toutes les demandes ont échoué sans rendre de résultats. Rien n’est dû.
object[]
requis
Une entrée par demande au laboratoire — une prise de sang répartie sur plusieurs tubes ou laboratoires en comporte plusieurs. Le status principal passe à completed dès que toutes les entrées sont clôturées et que l’une d’elles a rendu ses résultats.
object[]
requis
Tableau des résultats de biomarqueurs cliniques.
object[]
requis
Tableau des résultats de biomarqueurs génétiques.
object[]
requis
Documents de compte rendu de laboratoire. Utilise GET /api/v1/documents/{id} pour télécharger chaque fichier.

Appels répétés

Aniva conserve la réponse de ce point de terminaison pendant 60 minutes pour chaque clé API. Un appel répété pendant ce délai reçoit la réponse conservée tant que le rendez-vous et ses résultats n’ont pas changé. Après une modification, tu reçois une nouvelle réponse. Les en-têtes Cache-Status et Age indiquent que la réponse est conservée et depuis combien de temps. Pour être informé immédiatement d’un changement, abonne-toi aux événements webhook appointment.results.updated, appointment.results.completed et appointment.results.fault. Voir Lectures répétées.

Réponses d’erreur