Passer au contenu principal
POST
Importe un fichier sur un profil. Envoie-le en multipart/form-data. Sans extract_results, Aniva se contente de stocker le fichier. Avec extract_results: true, Aniva extrait aussi les valeurs de laboratoire du fichier. Tu n’as pas à indiquer le type de compte rendu du fichier. Aniva décide. Un fichier sans résultats de laboratoire, comme un courrier médical, se termine en stored et ne constitue pas une erreur. Consulte les valeurs avec Obtenir les résultats d’un document. Tu n’as pas besoin de faire du polling : abonne-toi aux webhooks document.results.*. Nécessite le scope documents_upload sur un groupe de profils du profil. extract_results: true nécessite aussi le scope documents_extract_results sur le même groupe. Demande à Aniva de les ajouter. Le document appartient à ce groupe : les clés disposant de results_view sur ce groupe peuvent lire le document et ses résultats. Envoie un en-tête Idempotency-Key facultatif pour pouvoir relancer l’import en toute sécurité. Voir Idempotence.

Ce que fait l’extraction

Avec extract_results: true :
  1. Aniva envoie le fichier à ses sous-traitants OCR et IA pour lire les valeurs.
  2. Les valeurs apparaissent dans l’app Aniva du membre, comme tout autre résultat.
  3. Chaque valeur porte origin: partner_upload et le même status que tout autre résultat. Une valeur dont la vérification automatique d’Aniva doute a le statut likely_wrong.
Sans elle, le fichier n’est envoyé à aucun service externe si tu envoies aussi document_date.
  • La lecture automatique peut mal lire une valeur, une unité ou une date. Le fichier d’origine reste la source de vérité. Vérifie une valeur sur ce fichier avant de l’utiliser pour une décision médicale. Les valeurs extraites ne sont pas un diagnostic.
  • Les sous-traitants sont Mistral AI (OCR, UE) et Google Cloud Vertex AI, accessible via Vercel AI Gateway (extraction, peut traiter des données hors UE). Ils traitent le fichier uniquement pour le lire.
  • Tu as besoin d’une base légale pour importer les données de santé d’un membre, normalement son consentement explicite. Tu en es responsable.

Requête

Champs du formulaire

file
requis
Le fichier. PDF, DOC, DOCX, PNG ou JPEG, 4 MB maximum.
string
requis
UUID du profil auquel le document appartient.
boolean
défaut:"false"
true pour lire les valeurs de laboratoire dans le fichier. Envoie true ou false.
string
La date du prélèvement au format YYYY-MM-DD, si tu la connais. Sans elle, Aniva lit la date dans le fichier.

Réponse

L’API renvoie 201 Created lorsqu’elle a uniquement stocké le fichier, et 202 Accepted lorsque l’extraction est lancée.
string
requis
Identifiant du document (UUID). Utilise-le avec Obtenir les résultats du document et Télécharger le document.
string
requis
processing pendant qu’Aniva extrait les valeurs, ou stored lorsque le fichier est uniquement stocké.
string
requis
Le profil auquel le document appartient.
string
La date du prélèvement que tu as envoyée, ou celle qu’Aniva a lue dans un fichier stocké. Peut être null.
string
requis
L’URL Obtenir les résultats du document de ce document.
string
requis
Nom du fichier pour l’affichage, le même que celui envoyé par Télécharger le document.
string
requis
Le nom du fichier que tu as importé.
string
requis
Toujours partner_upload.
string
requis
Type de média du fichier, par ex. application/pdf.
string
Version du contenu du fichier. Peut être null.
integer
Taille du fichier en octets. Peut être null.
string
Toujours null pour un document importé.

Réponses d’erreur