Přejít na hlavní obsah
POST
Nahraj jeden soubor do profilu. Pošli ho jako multipart/form-data. Bez extract_results Aniva soubor jen uloží. S extract_results: true z něj Aniva také vyčte laboratorní hodnoty. Nemusíš uvádět, o jaký typ zprávy jde. Rozhodne o tom Aniva. Soubor bez laboratorních výsledků, například lékařská zpráva, skončí ve stavu stored a není to chyba. Hodnoty načti pomocí Získat výsledky dokumentu. Nemusíš dělat polling: přihlas se k odběru webhooků document.results.*. Vyžaduje scope documents_upload pro skupinu profilů daného profilu. extract_results: true také vyžaduje scope documents_extract_results pro stejnou skupinu. O jejich přidání požádej Anivu. Dokument patří do této skupiny: klíče se scope results_view pro tuto skupinu mohou číst dokument i jeho výsledky. Pošli volitelnou hlavičku Idempotency-Key, aby šlo nahrání bezpečně opakovat. Viz Idempotence.

Co dělá extrakce

S extract_results: true:
  1. Aniva pošle soubor svým dílčím zpracovatelům pro OCR a AI, aby přečetli hodnoty.
  2. Hodnoty se zobrazí v aplikaci Aniva daného člena stejně jako každý jiný výsledek.
  3. Každá hodnota má origin: partner_upload a stejný status jako každý jiný výsledek. Hodnota, o které automatická kontrola Aniva pochybuje, má stav likely_wrong.
Bez toho se soubor neposílá žádné externí službě, pokud zároveň pošleš document_date.
  • Automatické čtení může špatně přečíst hodnotu, jednotku nebo datum. Původní soubor zůstává zdrojem pravdy. Než hodnotu použiješ pro lékařské rozhodnutí, ověř ji podle něj. Extrahované hodnoty nejsou diagnóza.
  • Dílčími zpracovateli jsou Mistral AI (OCR, EU) a Google Cloud Vertex AI dostupný přes Vercel AI Gateway (extrakce, může zpracovávat mimo EU). Soubor zpracovávají jen proto, aby ho přečetli.
  • K nahrání zdravotních údajů člena potřebuješ právní základ, obvykle jeho výslovný souhlas. Zodpovídáš za něj.

Požadavek

Pole formuláře

file
povinné
Soubor. PDF, DOC, DOCX, PNG nebo JPEG, maximálně 4 MB.
string
povinné
UUID profilu, ke kterému dokument patří.
boolean
výchozí:"false"
true pro přečtení laboratorních hodnot ze souboru. Pošli true nebo false.
string
Datum odběru ve formátu YYYY-MM-DD, pokud ho znáš. Bez něj Aniva přečte datum ze souboru.

Odpověď

API vrátí 201 Created, když soubor jen uložilo, a 202 Accepted, když běží extrakce.
string
povinné
ID dokumentu (UUID). Použij ho pro Získat výsledky dokumentu a Stáhnout dokument.
string
povinné
processing, dokud Aniva extrahuje hodnoty, nebo stored, když je soubor jen uložený.
string
povinné
Profil, ke kterému dokument patří.
string
Odeslané datum odběru nebo datum, které Aniva přečetla z uloženého souboru. Může být null.
string
povinné
URL Získat výsledky dokumentu pro tento dokument.
string
povinné
Název souboru pro zobrazení, stejný, jaký posílá Stáhnout dokument.
string
povinné
Název nahraného souboru.
string
povinné
Vždy partner_upload.
string
povinné
Typ média souboru, např. application/pdf.
string
Verze obsahu souboru. Může být null.
integer
Velikost souboru v bajtech. Může být null.
string
U nahraného dokumentu vždy null.

Chybové odpovědi