Ugrás a fő tartalomhoz
POST
Tölts fel egy fájlt egy profilhoz. Küldd multipart/form-data formátumban. Az extract_results nélkül az Aniva csak tárolja a fájlt. Az extract_results: true megadásával az Aniva a laborértékeket is kiolvassa a fájlból. Nem kell megadnod, milyen típusú lelet a fájl. Az Aniva dönti el. A laboreredményeket nem tartalmazó fájl, például egy orvosi levél, stored állapotban zárul, és nem számít hibának. Olvasd le az értékeket a Dokumentum eredményeinek lekérése segítségével. Nem kell folyamatosan lekérdezned: iratkozz fel a document.results.* webhookokra. A documents_upload scope szükséges hozzá a profil egyik profilcsoportján. Az extract_results: true a documents_extract_results scope-ot is igényli ugyanazon a csoporton. Kérd meg az Anivát, hogy adja hozzá ezeket. A dokumentum ehhez a csoporthoz tartozik: a rajta results_view scope-pal rendelkező kulcsok olvashatják a dokumentumot és az eredményeit. Küldj egy opcionális Idempotency-Key fejlécet, hogy a feltöltés biztonságosan újrapróbálható legyen. Lásd: Idempotencia.

Mit csinál a kinyerés

Az extract_results: true megadásával:
  1. Az Aniva elküldi a fájlt az OCR- és AI-aladatfeldolgozóinak, hogy kiolvassák az értékeket.
  2. Az értékek megjelennek a tag Aniva alkalmazásában, mint minden más eredmény.
  3. Minden érték origin: partner_upload jelölést és ugyanazt a status mezőt kapja, mint minden más eredmény. Amelyik értéket az Aniva automatikus ellenőrzése kétségbe vonja, annak likely_wrong a státusza.
Enélkül a fájl egyetlen külső szolgáltatáshoz sem kerül, ha a document_date mezőt is elküldöd.
  • Az automatikus kiolvasás félreolvashat egy értéket, mértékegységet vagy dátumot. Az eredeti fájl marad az irányadó forrás. Vesd össze vele az értéket, mielőtt orvosi döntéshez használod. A kiolvasott értékek nem minősülnek diagnózisnak.
  • Az aladatfeldolgozók a Mistral AI (OCR, EU) és a Google Cloud Vertex AI, a Vercel AI Gateway-en keresztül elérve (kiolvasás, az EU-n kívül is feldolgozhat). A fájlt kizárólag a kiolvasás céljából dolgozzák fel.
  • Egy tag egészségügyi adatainak feltöltéséhez jogalapra van szükséged, általában a tag kifejezett hozzájárulására. Ez a te felelősséged.

Kérés

Űrlapmezők

file
kötelező
A fájl. PDF, DOC, DOCX, PNG vagy JPEG, legfeljebb 4 MB.
string
kötelező
Annak a profilnak az UUID-je, amelyhez a dokumentum tartozik.
boolean
alapértelmezett:"false"
true a laborértékek fájlból való kiolvasásához. Küldj true vagy false értéket.
string
A mintavétel dátuma YYYY-MM-DD formátumban, ha ismered. Enélkül az Aniva kiolvassa a dátumot a fájlból.

Válasz

Az API 201 Created választ ad vissza, ha csak tárolta a fájlt, és 202 Accepted választ, ha a kiolvasás fut.
string
kötelező
Dokumentumazonosító (UUID). Használd a Dokumentum eredményeinek lekérése és a Dokumentum letöltése végpontokkal.
string
kötelező
processing, amíg az Aniva kiolvassa az értékeket, vagy stored, ha a fájlt csak tárolta.
string
kötelező
A profil, amelyhez a dokumentum tartozik.
string
Az általad küldött mintavételi dátum, vagy amelyet az Aniva egy tárolt fájlból olvasott ki. Lehet null.
string
kötelező
string
kötelező
Megjelenítendő fájlnév, ugyanaz, amelyet a Dokumentum letöltése küld.
string
kötelező
Az általad feltöltött fájlnév.
string
kötelező
Mindig partner_upload.
string
kötelező
A fájl médiatípusa, pl. application/pdf.
string
A fájltartalom verziója. Lehet null.
integer
Fájlméret bájtban. Lehet null.
string
Feltöltött dokumentumnál mindig null.

Hibaválaszok