Saltar al contingut principal
POST
Puja un fitxer a un perfil. Envia’l com a multipart/form-data. Sense extract_results, Aniva només desa el fitxer. Amb extract_results: true, Aniva també llegeix els valors de laboratori del fitxer. No cal que indiquis quin tipus d’informe és el fitxer. Aniva ho decideix. Un fitxer sense resultats de laboratori, com ara una carta mèdica, acaba com a stored i no és un error. Llegeix els valors amb Obtén els resultats del document. No cal que facis consultes periòdiques: subscriu-te als webhooks document.results.*. Requereix l’àmbit documents_upload en un grup de perfils del perfil. extract_results: true també requereix l’àmbit documents_extract_results al mateix grup. Demana a Aniva que els afegeixi. El document pertany a aquest grup: les claus amb results_view en aquest grup llegeixen el document i els seus resultats. Envia una capçalera opcional Idempotency-Key perquè la pujada es pugui reintentar de manera segura. Consulta Idempotència.

Què fa l’extracció

Amb extract_results: true:
  1. Aniva envia el fitxer als seus subencarregats d’OCR i IA per llegir-ne els valors.
  2. Els valors apareixen a l’app d’Aniva del membre, com qualsevol altre resultat.
  3. Cada valor porta origin: partner_upload i el mateix status que qualsevol altre resultat. Un valor que la comprovació automàtica d’Aniva posa en dubte té l’estat likely_wrong.
Sense això, el fitxer no s’envia a cap servei extern si també envies document_date.
  • La lectura automàtica pot llegir malament un valor, una unitat o una data. El fitxer original continua sent la font de referència. Contrasta-hi el valor abans de fer-lo servir per a una decisió mèdica. Els valors extrets no són un diagnòstic.
  • Els subencarregats són Mistral AI (OCR, UE) i Google Cloud Vertex AI, als quals s’accedeix a través de Vercel AI Gateway (extracció, pot processar dades fora de la UE). Només processen el fitxer per llegir-lo.
  • Necessites una base jurídica per pujar les dades de salut d’un membre, normalment el seu consentiment explícit. N’ets responsable.

Sol·licitud

Camps del formulari

file
requerit
El fitxer. PDF, DOC, DOCX, PNG o JPEG, de com a màxim 4 MB.
string
requerit
UUID del perfil al qual pertany el document.
boolean
predeterminat:"false"
true per llegir els valors de laboratori del fitxer. Envia true o false.
string
La data de la mostra en format YYYY-MM-DD, si la saps. Sense aquesta dada, Aniva llegeix la data del fitxer.

Resposta

L’API retorna 201 Created quan només ha desat el fitxer, i 202 Accepted quan s’executa l’extracció.
string
requerit
ID del document (UUID). Fes-lo servir amb Obtén els resultats del document i Descarrega el document.
string
requerit
processing mentre Aniva extreu els valors, o stored quan el fitxer només s’ha desat.
string
requerit
El perfil al qual pertany el document.
string
La data de la mostra que has enviat, o la que Aniva ha llegit d’un fitxer desat. Pot ser null.
string
requerit
L’URL d’Obtén els resultats del document d’aquest document.
string
requerit
Nom del fitxer per mostrar, el mateix que envia Descarrega el document.
string
requerit
El nom del fitxer que has pujat.
string
requerit
Sempre partner_upload.
string
requerit
Tipus de contingut del fitxer, p. ex., application/pdf.
string
Versió del contingut del fitxer. Pot ser null.
integer
Mida del fitxer en bytes. Pot ser null.
string
Sempre null per a un document pujat.

Respostes d’error