Vai al contenuto principale
POST
Carica un file su un profilo. Invialo come multipart/form-data. Senza extract_results, Aniva si limita a salvare il file. Con extract_results: true, Aniva legge anche i valori di laboratorio dal file. Non devi indicare di che tipo di referto si tratta. Decide Aniva. Un file senza risultati di laboratorio, come una lettera medica, termina in stato stored e non è un errore. Leggi i valori con Ottieni risultati del documento. Non devi fare polling: iscriviti ai webhook document.results.*. Richiede lo scope documents_upload su un gruppo di profili del profilo. extract_results: true richiede anche lo scope documents_extract_results sullo stesso gruppo. Chiedi ad Aniva di aggiungerli. Il documento appartiene a quel gruppo: le chiavi con results_view su quel gruppo possono leggere il documento e i suoi risultati. Invia un header opzionale Idempotency-Key per rendere sicuro un nuovo tentativo di caricamento. Consulta Idempotenza.

Cosa fa l’estrazione

Con extract_results: true:
  1. Aniva invia il file ai suoi sub-responsabili OCR e AI per leggere i valori.
  2. I valori compaiono nell’app Aniva del membro, come ogni altro risultato.
  3. Ogni valore ha origin: partner_upload e lo stesso status di ogni altro risultato. Un valore su cui il controllo automatico di Aniva ha dubbi ha stato likely_wrong.
Senza di essa, il file non viene inviato a nessun servizio esterno se invii anche document_date.
  • La lettura automatica può leggere in modo errato un valore, un’unità o una data. Il file originale resta la fonte di riferimento. Verifica un valore sul file prima di usarlo per una decisione medica. I valori estratti non sono una diagnosi.
  • I sub-responsabili sono Mistral AI (OCR, UE) e Google Cloud Vertex AI, raggiunto tramite Vercel AI Gateway (estrazione, può elaborare dati fuori dall’UE). Elaborano il file solo per leggerlo.
  • Ti serve una base giuridica per caricare i dati sanitari di un membro, di norma il suo consenso esplicito. La responsabilità è tua.

Richiesta

Campi del modulo

file
obbligatorio
Il file. PDF, DOC, DOCX, PNG o JPEG, al massimo 4 MB.
string
obbligatorio
UUID del profilo a cui appartiene il documento.
boolean
predefinito:"false"
true per leggere i valori di laboratorio dal file. Invia true o false.
string
La data del campione in formato YYYY-MM-DD, se la conosci. Se non la invii, Aniva legge la data dal file.

Risposta

L’API restituisce 201 Created quando ha solo archiviato il file e 202 Accepted quando esegue l’estrazione.
string
obbligatorio
ID del documento (UUID). Usalo con Ottieni risultati del documento e Scarica documento.
string
obbligatorio
processing mentre Aniva estrae i valori, oppure stored quando il file viene solo archiviato.
string
obbligatorio
Il profilo a cui appartiene il documento.
string
La data del campione che hai inviato o quella letta da Aniva da un file archiviato. Può essere null.
string
obbligatorio
L’URL di Ottieni risultati del documento per questo documento.
string
obbligatorio
Nome del file da mostrare, lo stesso inviato da Scarica documento.
string
obbligatorio
Il nome del file che hai caricato.
string
obbligatorio
Sempre partner_upload.
string
obbligatorio
Tipo di media del file, ad es. application/pdf.
string
Versione del contenuto del file. Può essere null.
integer
Dimensione del file in byte. Può essere null.
string
Sempre null per un documento caricato.

Risposte di errore