Salt la conținutul principal
POST
Încarcă un fișier pe un profil. Trimite-l ca multipart/form-data. Fără extract_results, Aniva doar stochează fișierul. Cu extract_results: true, Aniva citește și valorile de laborator din fișier. Nu spui ce fel de raport este fișierul. Aniva decide. Un fișier fără rezultate de laborator, cum ar fi o scrisoare medicală, ajunge în starea stored și nu este o eroare. Citește valorile cu Obține rezultatele documentului. Nu trebuie să faci polling: abonează-te la webhook-urile document.results.*. Necesită scope-ul documents_upload pe un grup de profiluri al profilului. extract_results: true necesită și scope-ul documents_extract_results pe același grup. Cere echipei Aniva să le adauge. Documentul aparține acelui grup: cheile cu results_view pe acesta citesc documentul și rezultatele lui. Trimite un antet opțional Idempotency-Key pentru a putea reîncerca încărcarea în siguranță. Vezi Idempotență.

Ce face extragerea

Cu extract_results: true:
  1. Aniva trimite fișierul către subprocesatorii săi OCR și AI pentru a citi valorile.
  2. Valorile apar în aplicația Aniva a membrului, la fel ca orice alt rezultat.
  3. Fiecare valoare are origin: partner_upload și același status ca orice alt rezultat. O valoare pe care verificarea automată a Aniva o pune la îndoială are statusul likely_wrong.
Fără ea, fișierul nu ajunge la niciun serviciu extern dacă trimiți și document_date.
  • Citirea automată poate interpreta greșit o valoare, o unitate sau o dată. Fișierul original rămâne sursa de adevăr. Verifică o valoare față de el înainte să o folosești pentru o decizie medicală. Valorile extrase nu reprezintă un diagnostic.
  • Subprocesatorii sunt Mistral AI (OCR, UE) și Google Cloud Vertex AI, accesat prin Vercel AI Gateway (extragere, poate procesa în afara UE). Aceștia procesează fișierul doar pentru a-l citi.
  • Ai nevoie de un temei legal pentru a încărca datele de sănătate ale unui membru, de obicei consimțământul explicit al membrului. Ești responsabil pentru acesta.

Cerere

Câmpurile formularului

file
obligatoriu
Fișierul. PDF, DOC, DOCX, PNG sau JPEG, cel mult 4 MB.
string
obligatoriu
UUID-ul profilului căruia îi aparține documentul.
boolean
implicit:"false"
true pentru a citi valorile de laborator din fișier. Trimite true sau false.
string
Data probei în format YYYY-MM-DD, când o știi. Fără ea, Aniva citește data din fișier.

Răspuns

API-ul returnează 201 Created când doar a stocat fișierul și 202 Accepted când rulează extragerea.
string
obligatoriu
ID-ul documentului (UUID). Folosește-l cu Obține rezultatele documentului și Descarcă documentul.
string
obligatoriu
processing cât timp Aniva extrage valorile sau stored când fișierul este doar stocat.
string
obligatoriu
Profilul căruia îi aparține documentul.
string
Data probei pe care ai trimis-o sau cea citită de Aniva dintr-un fișier stocat. Poate fi null.
string
obligatoriu
URL-ul Obține rezultatele documentului al acestui document.
string
obligatoriu
Numele fișierului pentru afișare, același pe care îl trimite Descarcă documentul.
string
obligatoriu
Numele fișierului pe care l-ai încărcat.
string
obligatoriu
Întotdeauna partner_upload.
string
obligatoriu
Tipul media al fișierului, de ex. application/pdf.
string
Versiunea conținutului fișierului. Poate fi null.
integer
Dimensiunea fișierului în octeți. Poate fi null.
string
Întotdeauna null pentru un document încărcat.

Răspunsuri de eroare