Hoppa till huvudinnehåll
POST
Ladda upp en fil till en profil. Skicka den som multipart/form-data. Utan extract_results lagrar Aniva bara filen. Med extract_results: true läser Aniva också ut labbvärdena ur filen. Du anger inte vilken typ av rapport filen är. Aniva avgör det. En fil utan labbresultat, till exempel ett läkarbrev, slutar som stored och är inget fel. Läs värdena med Hämta dokumentresultat. Du behöver inte polla: prenumerera på webhooks för document.results.*. Kräver scopet documents_upload för en av profilens profilgrupper. extract_results: true kräver dessutom scopet documents_extract_results för samma grupp. Be Aniva lägga till dem. Dokumentet tillhör den gruppen: nycklar med results_view för gruppen kan läsa dokumentet och dess resultat. Skicka en valfri Idempotency-Key-header för att göra uppladdningen säker att köra om. Se Idempotens.

Vad extraheringen gör

Med extract_results: true:
  1. Aniva skickar filen till sina underbiträden för OCR och AI för att läsa av värdena.
  2. Värdena visas i medlemmens Aniva-app, precis som alla andra resultat.
  3. Varje värde har origin: partner_upload och samma status som alla andra resultat. Ett värde som Anivas automatiska kontroll ifrågasätter får status likely_wrong.
Utan den skickas filen inte till någon extern tjänst om du också skickar document_date.
  • Automatisk avläsning kan läsa fel på ett värde, en enhet eller ett datum. Originalfilen förblir facit. Kontrollera ett värde mot den innan du använder det för ett medicinskt beslut. Extraherade värden är ingen diagnos.
  • Underbiträdena är Mistral AI (OCR, EU) och Google Cloud Vertex AI, som nås via Vercel AI Gateway (extrahering, kan behandla data utanför EU). De behandlar bara filen för att läsa av den.
  • Du behöver en rättslig grund för att ladda upp en medlems hälsodata, normalt medlemmens uttryckliga samtycke. Du ansvarar för detta.

Förfrågan

Formulärfält

file
obligatorisk
Filen. PDF, DOC, DOCX, PNG eller JPEG, högst 4 MB.
string
obligatorisk
UUID för profilen som dokumentet tillhör.
boolean
standard:"false"
true för att läsa av labbvärdena ur filen. Skicka true eller false.
string
Provtagningsdatumet i formatet YYYY-MM-DD, när du känner till det. Utan det läser Aniva av datumet från filen.

Svar

API:et returnerar 201 Created när filen bara har sparats, och 202 Accepted när extrahering körs.
string
obligatorisk
Dokument-ID (UUID). Använd det med Hämta dokumentresultat och Ladda ner dokument.
string
obligatorisk
processing medan Aniva extraherar värdena, eller stored när filen bara har sparats.
string
obligatorisk
Profilen som dokumentet tillhör.
string
Provtagningsdatumet du skickade, eller det som Aniva läste av från en sparad fil. Kan vara null.
string
obligatorisk
URL:en till Hämta dokumentresultat för det här dokumentet.
string
obligatorisk
Filnamn för visning, samma som Ladda ner dokument skickar.
string
obligatorisk
Filnamnet du laddade upp.
string
obligatorisk
Alltid partner_upload.
string
obligatorisk
Filens mediatyp, t.ex. application/pdf.
string
Version av filinnehållet. Kan vara null.
integer
Filstorlek i byte. Kan vara null.
string
Alltid null för ett uppladdat dokument.

Felsvar