Loading...
Referencia completa de cada endpoint de la API de MedExtract. Expande cada tarjeta para ver los parámetros disponibles y los requisitos.
/healthVerificación de salud básica. Devuelve HTTP 200 cuando el servicio está en ejecución. Usa esto para sondas de vida.
/readySondeo de disponibilidad. Devuelve HTTP 200 cuando el servicio está completamente inicializado y listo para aceptar solicitudes. Usa esto para sondas de disponibilidad en orquestadores de contenedores.
Todos los endpoints a continuación requieren autenticación mediante la cabecera X-API-Key.
/v1/lab/parseAuthSube una imagen de informe de laboratorio (JPEG, PNG, TIFF, WebP) y recibe resultados estructurados con códigos LOINC, rangos de referencia e interpretaciones clínicas.
/v1/lab/parse-pdfAuthSube un PDF de informe de laboratorio y recibe resultados estructurados. Soporta documentos de múltiples páginas con detección y extracción automática de tablas.
/v1/lab/fhirAuthSube una imagen o PDF de informe de laboratorio y recibe un Bundle FHIR R4 con recursos Patient y Observation. Compatible con cualquier sistema HCE compatible con FHIR.
Devuelto por /v1/lab/parse y /v1/lab/parse-pdf
| Campo | Tipo | Descripción |
|---|---|---|
patient | object | Datos demográficos del paciente (nombre, edad, sexo, fecha) |
sections | array | Array de secciones de laboratorio, cada una con un nombre y un array de resultados |
sections[].results[] | object | Resultado individual con test_name, test_name_en, value, numeric_value, unit, unit_ucum, reference_range, reference_low, reference_high, loinc_code, panel, interpretation, flag, plausibility, confidence, needs_review |
summary | object | Recuentos resumen: total_tests, flagged, needs_review |
metadata | object | Metadatos de procesamiento: engine, processing_time_ms, confidence_mean |
Devuelto por /v1/lab/fhir
| Campo | Tipo | Descripción |
|---|---|---|
resourceType | string | Siempre "Bundle" |
type | string | Siempre "collection" |
entry | array | Array de recursos FHIR (Patient, Observation) |
| Estado | Significado | Causa común |
|---|---|---|
400 | Solicitud incorrecta | Falta el archivo, formato inválido o parámetros de consulta inválidos |
401 | No autorizado | Falta la cabecera X-API-Key o es inválida |
413 | Carga demasiado grande | El archivo excede el tamaño máximo de subida (20 MB) |
422 | Entidad no procesable | No se pudo procesar el archivo (corrupto o ilegible) |
429 | Demasiadas solicitudes | Límite de tasa excedido. Revisa la cabecera Retry-After. |
500 | Error interno del servidor | Error inesperado del servidor. Contacta con soporte si persiste. |