Pāriet uz galveno saturu
POST
Augšupielādē vienu failu profilā. Nosūti to kā multipart/form-data. Bez extract_results Aniva tikai saglabā failu. Ar extract_results: true Aniva arī nolasa laboratorijas vērtības no faila. Tev nav jānorāda, kāda veida pārskats ir failā. To nosaka Aniva. Fails bez laboratorijas rezultātiem, piemēram, ārsta vēstule, nonāk statusā stored, un tā nav kļūda. Nolasi vērtības ar Iegūt dokumenta rezultātus. Tev nav regulāri jāveic pieprasījumi: abonē document.results.* webhook paziņojumus. Nepieciešama documents_upload darbības joma kādai no profila grupām. extract_results: true prasa arī documents_extract_results darbības jomu tai pašai grupai. Palūdz Aniva tās pievienot. Dokuments pieder šai grupai: atslēgas ar results_view tajā var lasīt dokumentu un tā rezultātus. Nosūti neobligāto galveni Idempotency-Key, lai augšupielādi varētu droši atkārtot. Skati Idempotence.

Ko dara izgūšana

Ar extract_results: true:
  1. Aniva nosūta failu saviem OCR un MI apakšapstrādātājiem, lai nolasītu vērtības.
  2. Vērtības parādās dalībnieka Aniva lietotnē tāpat kā visi citi rezultāti.
  3. Katrai vērtībai ir origin: partner_upload un tāds pats status kā jebkuram citam rezultātam. Vērtībai, par kuru Aniva automātiskā pārbaude šaubās, ir statuss likely_wrong.
Bez tā fails netiek sūtīts nevienam ārējam pakalpojumam, ja nosūti arī document_date.
  • Automātiskā nolasīšana var kļūdaini nolasīt vērtību, mērvienību vai datumu. Oriģinālais fails paliek primārais avots. Salīdzini vērtību ar to, pirms izmanto to medicīniskam lēmumam. Izgūtās vērtības nav diagnoze.
  • Apakšapstrādātāji ir Mistral AI (OCR, ES) un Google Cloud Vertex AI, kam piekļūst caur Vercel AI Gateway (datu izgūšana, var apstrādāt ārpus ES). Tie apstrādā failu tikai tā nolasīšanai.
  • Lai augšupielādētu dalībnieka veselības datus, tev vajadzīgs juridisks pamats, parasti dalībnieka skaidri pausta piekrišana. Tu par to atbildi.

Pieprasījums

Veidlapas lauki

file
obligāts
Fails. PDF, DOC, DOCX, PNG vai JPEG, ne vairāk kā 4 MB.
string
obligāts
Tā profila UUID, kuram pieder dokuments.
boolean
noklusējums:"false"
true, lai nolasītu laboratorijas vērtības no faila. Nosūti true vai false.
string
Parauga datums YYYY-MM-DD formātā, ja to zini. Bez tā Aniva nolasa datumu no faila.

Atbilde

API atgriež 201 Created, kad tas tikai saglabāja failu, un 202 Accepted, kad notiek datu izgūšana.
string
obligāts
Dokumenta ID (UUID). Izmanto to ar Iegūt dokumenta rezultātus un Lejupielādēt dokumentu.
string
obligāts
processing, kamēr Aniva izgūst vērtības, vai stored, kad fails ir tikai saglabāts.
string
obligāts
Profils, kuram pieder dokuments.
string
Parauga datums, ko nosūtīji, vai tas, ko Aniva nolasīja no saglabātā faila. Var būt null.
string
obligāts
Šī dokumenta Iegūt dokumenta rezultātus URL.
string
obligāts
Attēlojamais faila nosaukums — tas pats, ko nosūta Lejupielādēt dokumentu.
string
obligāts
Faila nosaukums, ko augšupielādēji.
string
obligāts
Vienmēr partner_upload.
string
obligāts
Faila mediju tips, piem., application/pdf.
string
Faila satura versija. Var būt null.
integer
Faila izmērs baitos. Var būt null.
string
Augšupielādētam dokumentam vienmēr null.

Kļūdu atbildes