Zum Hauptinhalt springen
POST
Lade eine Datei in ein Profil hoch. Sende sie als multipart/form-data. Ohne extract_results speichert Aniva die Datei nur. Mit extract_results: true liest Aniva auch die Laborwerte aus der Datei aus. Du gibst nicht an, um welche Art von Bericht es sich handelt. Aniva entscheidet das. Eine Datei ohne Laborergebnisse, wie z. B. ein Arztbrief, endet mit stored und ist kein Fehler. Lies die Werte mit Dokumentergebnisse abrufen aus. Du musst nicht pollen: Abonniere die Webhooks document.results.*. Erfordert den Scope documents_upload für eine Profilgruppe des Profils. extract_results: true erfordert zusätzlich den Scope documents_extract_results für dieselbe Gruppe. Bitte Aniva, diese hinzuzufügen. Das Dokument gehört zu dieser Gruppe: Schlüssel mit results_view für diese Gruppe lesen das Dokument und seine Ergebnisse. Sende einen optionalen Idempotency-Key-Header, damit der Upload sicher wiederholt werden kann. Siehe Idempotenz.

Was die Extraktion macht

Mit extract_results: true:
  1. Aniva sendet die Datei an seine OCR- und KI-Unterauftragsverarbeiter, um die Werte auszulesen.
  2. Die Werte erscheinen in der Aniva-App des Mitglieds, wie jedes andere Ergebnis.
  3. Jeder Wert hat origin: partner_upload und denselben status wie jedes andere Ergebnis. Ein Wert, den die automatische Prüfung von Aniva anzweifelt, hat den Status likely_wrong.
Ohne Extraktion geht die Datei an keinen externen Dienst, wenn du auch document_date sendest.
  • Automatisches Auslesen kann einen Wert, eine Einheit oder ein Datum falsch lesen. Die Originaldatei bleibt maßgeblich. Gleiche einen Wert mit ihr ab, bevor du ihn für eine medizinische Entscheidung nutzt. Extrahierte Werte sind keine Diagnose.
  • Die Unterauftragsverarbeiter sind Mistral AI (OCR, EU) und Google Cloud Vertex AI, erreichbar über das Vercel AI Gateway (Extraktion, kann außerhalb der EU verarbeiten). Sie verarbeiten die Datei nur, um sie auszulesen.
  • Du brauchst eine Rechtsgrundlage, um Gesundheitsdaten eines Mitglieds hochzuladen, normalerweise die ausdrückliche Einwilligung des Mitglieds. Du bist dafür verantwortlich.

Anfrage

Formularfelder

file
erforderlich
Die Datei. PDF, DOC, DOCX, PNG oder JPEG, maximal 4 MB.
string
erforderlich
UUID des Profils, zu dem das Dokument gehört.
boolean
Standard:"false"
true, um die Laborwerte aus der Datei auszulesen. Sende true oder false.
string
Das Probendatum im Format YYYY-MM-DD, wenn du es kennst. Ohne diese Angabe liest Aniva das Datum aus der Datei aus.

Antwort

Die API gibt 201 Created zurück, wenn sie die Datei nur gespeichert hat, und 202 Accepted, wenn die Extraktion läuft.
string
erforderlich
Dokument-ID (UUID). Verwende sie mit Dokumentergebnisse abrufen und Dokument herunterladen.
string
erforderlich
processing, während Aniva die Werte extrahiert, oder stored, wenn die Datei nur gespeichert wird.
string
erforderlich
Das Profil, zu dem das Dokument gehört.
string
Das Probendatum, das du gesendet hast, oder das Datum, das Aniva aus einer gespeicherten Datei ausgelesen hat. Kann null sein.
string
erforderlich
Die URL von Dokumentergebnisse abrufen für dieses Dokument.
string
erforderlich
Dateiname für die Anzeige, derselbe, den Dokument herunterladen sendet.
string
erforderlich
Der Dateiname, den du hochgeladen hast.
string
erforderlich
Immer partner_upload.
string
erforderlich
Medientyp der Datei, z. B. application/pdf.
string
Version des Dateiinhalts. Kann null sein.
integer
Dateigröße in Bytes. Kann null sein.
string
Bei einem hochgeladenen Dokument immer null.

Fehlerantworten