Naar hoofdinhoud gaan
POST
Upload één bestand naar een profiel. Stuur het als multipart/form-data. Zonder extract_results slaat Aniva het bestand alleen op. Met extract_results: true leest Aniva ook de labwaarden uit het bestand. Je geeft niet aan wat voor soort rapport het bestand is. Aniva bepaalt dat. Een bestand zonder labresultaten, zoals een artsenbrief, krijgt de status stored en is geen fout. Lees de waarden met Documentresultaten ophalen. Je hoeft niet te pollen: abonneer je op de document.results.*-webhooks. Vereist de documents_upload-scope voor een profielgroep van het profiel. extract_results: true vereist daarnaast de documents_extract_results-scope voor dezelfde groep. Vraag Aniva om deze toe te voegen. Het document hoort bij die groep: sleutels met results_view daarop kunnen het document en de resultaten lezen. Stuur optioneel een Idempotency-Key-header mee om de upload veilig opnieuw te kunnen proberen. Zie Idempotentie.

Wat uitlezen doet

Met extract_results: true:
  1. Aniva stuurt het bestand naar zijn OCR- en AI-subverwerkers om de waarden uit te lezen.
  2. De waarden verschijnen in de Aniva-app van het lid, net als elk ander resultaat.
  3. Elke waarde heeft origin: partner_upload en dezelfde status als elk ander resultaat. Een waarde waarover de automatische controle van Aniva twijfelt, heeft de status likely_wrong.
Zonder deze optie gaat het bestand niet naar een externe dienst als je ook document_date meestuurt.
  • Automatisch uitlezen kan een waarde, een eenheid of een datum verkeerd lezen. Het originele bestand blijft leidend. Controleer een waarde aan de hand daarvan voordat je die gebruikt voor een medische beslissing. Uitgelezen waarden zijn geen diagnose.
  • De subverwerkers zijn Mistral AI (OCR, EU) en Google Cloud Vertex AI, bereikt via de Vercel AI Gateway (extractie, kan buiten de EU verwerken). Ze verwerken het bestand alleen om het uit te lezen.
  • Je hebt een wettelijke grondslag nodig om gezondheidsgegevens van een lid te uploaden, meestal de uitdrukkelijke toestemming van het lid. Jij bent hiervoor verantwoordelijk.

Verzoek

Formuliervelden

file
vereist
Het bestand. PDF, DOC, DOCX, PNG of JPEG, maximaal 4 MB.
string
vereist
UUID van het profiel waar het document bij hoort.
boolean
standaard:"false"
true om de labwaarden uit het bestand uit te lezen. Stuur true of false.
string
De afnamedatum in YYYY-MM-DD-formaat, als je die weet. Zonder deze datum leest Aniva de datum uit het bestand.

Respons

De API geeft 201 Created terug wanneer het bestand alleen is opgeslagen, en 202 Accepted wanneer de extractie loopt.
string
vereist
Document-ID (UUID). Gebruik dit met Documentresultaten ophalen en Document downloaden.
string
vereist
processing terwijl Aniva de waarden uitleest, of stored wanneer het bestand alleen is opgeslagen.
string
vereist
Het profiel waar het document bij hoort.
string
De afnamedatum die je hebt meegestuurd, of de datum die Aniva uit een opgeslagen bestand heeft uitgelezen. Kan null zijn.
string
vereist
De URL voor Documentresultaten ophalen van dit document.
string
vereist
Bestandsnaam voor weergave, dezelfde die Document downloaden meestuurt.
string
vereist
De bestandsnaam die je hebt geüpload.
string
vereist
Altijd partner_upload.
string
vereist
Mediatype van het bestand, bijv. application/pdf.
string
Versie van de bestandsinhoud. Kan null zijn.
integer
Bestandsgrootte in bytes. Kan null zijn.
string
Altijd null voor een geüpload document.

Foutresponsen