Saltar al contenido principal
POST
Sube un archivo a un perfil. Envíalo como multipart/form-data. Sin extract_results, Aniva solo almacena el archivo. Con extract_results: true, Aniva también extrae los valores de laboratorio del archivo. No tienes que indicar qué tipo de informe es el archivo. Aniva lo decide. Un archivo sin resultados de laboratorio, como una carta del médico, termina como stored y no supone un error. Consulta los valores con Obtener resultados del documento. No necesitas hacer polling: suscríbete a los webhooks document.results.*. Requiere el permiso documents_upload en un grupo de perfiles del perfil. extract_results: true también requiere el permiso documents_extract_results en el mismo grupo. Pide a Aniva que los añada. El documento pertenece a ese grupo: las claves con results_view en él pueden leer el documento y sus resultados. Envía una cabecera opcional Idempotency-Key para que sea seguro reintentar la subida. Consulta Idempotencia.

Qué hace la extracción

Con extract_results: true:
  1. Aniva envía el archivo a sus subprocesadores de OCR e IA para leer los valores.
  2. Los valores aparecen en la app de Aniva del miembro, como cualquier otro resultado.
  3. Cada valor lleva origin: partner_upload y el mismo status que cualquier otro resultado. Un valor del que duda la comprobación automática de Aniva tiene el estado likely_wrong.
Sin ella, el archivo no se envía a ningún servicio externo si también envías document_date.
  • La lectura automática puede leer mal un valor, una unidad o una fecha. El archivo original sigue siendo la fuente de verdad. Comprueba el valor con él antes de usarlo para una decisión médica. Los valores extraídos no son un diagnóstico.
  • Los subprocesadores son Mistral AI (OCR, UE) y Google Cloud Vertex AI, a través de Vercel AI Gateway (extracción, puede procesar fuera de la UE). Solo procesan el archivo para leerlo.
  • Necesitas una base legal para subir los datos de salud de un miembro, normalmente su consentimiento explícito. Eres responsable de ello.

Solicitud

Campos del formulario

file
requerido
El archivo. PDF, DOC, DOCX, PNG o JPEG, como máximo 4 MB.
string
requerido
UUID del perfil al que pertenece el documento.
boolean
predeterminado:"false"
true para leer los valores de laboratorio del archivo. Envía true o false.
string
La fecha de la muestra en formato YYYY-MM-DD, si la conoces. Sin ella, Aniva lee la fecha del archivo.

Respuesta

La API devuelve 201 Created cuando solo ha almacenado el archivo y 202 Accepted cuando se ejecuta la extracción.
string
requerido
ID del documento (UUID). Úsalo con Obtener resultados del documento y Descargar documento.
string
requerido
processing mientras Aniva extrae los valores, o stored cuando el archivo solo se almacena.
string
requerido
El perfil al que pertenece el documento.
string
La fecha de la muestra que enviaste o la que Aniva leyó de un archivo almacenado. Puede ser null.
string
requerido
La URL de Obtener resultados del documento de este documento.
string
requerido
Nombre del archivo para mostrar, el mismo que envía Descargar documento.
string
requerido
El nombre del archivo que subiste.
string
requerido
Siempre partner_upload.
string
requerido
Tipo de medio del archivo, p. ej., application/pdf.
string
Versión del contenido del archivo. Puede ser null.
integer
Tamaño del archivo en bytes. Puede ser null.
string
Siempre null para un documento subido.

Respuestas de error