Inicio rápido

Pon en marcha la API de MedExtract en menos de 5 minutos. Analiza tu primer informe de laboratorio, recibe resultados codificados con LOINC y exporta un bundle FHIR R4.

Obtén tu clave API

Regístrate en MedExtract en dashboard.medextract.ai y navega a Settings → API Keys. Crea una nueva clave y cópiala. Necesitarás incluir esta clave en la cabecera X-API-Key de cada solicitud autenticada.

Mantén tu clave API en secreto. No la expongas en código del lado del cliente ni la incluyas en el control de versiones. Usa variables de entorno en producción.

Haz tu primera solicitud

Sube un PDF de informe de laboratorio al endpoint /v1/lab/parse-pdf. La API procesará el documento, extraerá los resultados, los mapeará a códigos LOINC y devolverá JSON estructurado.

Bash

curl -X POST https://api.medextract.ai/v1/lab/parse-pdf \  -H "X-API-Key: your-api-key" \  -F "file=@lab-report.pdf" \  -F "dpi=300"

Analiza la respuesta

La API devuelve un LabReportModel con datos demográficos del paciente, secciones organizadas con resultados individuales, un resumen y metadatos de procesamiento. Cada resultado incluye el nombre original en español, la traducción al inglés, el código LOINC, los rangos de referencia y la interpretación clínica.

Respuesta de ejemplo

{  "patient": {    "name": "Juan Garcia",    "age": 45,    "sex": "M",    "date": "2026-02-20"  },  "sections": [    {      "name": "Hematologia",      "results": [        {          "test_name": "Hemoglobina",          "test_name_en": "Hemoglobin",          "value": "14.2",          "numeric_value": 14.2,          "unit": "g/dL",          "unit_ucum": "g/dL",          "reference_range": "13.0 - 17.0",          "reference_low": 13.0,          "reference_high": 17.0,          "loinc_code": "718-7",          "panel": "CBC",          "interpretation": "normal",          "flag": null,          "plausibility": "plausible",          "confidence": 0.97,          "needs_review": false        },        {          "test_name": "Glucosa",          "test_name_en": "Glucose",          "value": "126",          "numeric_value": 126,          "unit": "mg/dL",          "unit_ucum": "mg/dL",          "reference_range": "70 - 100",          "reference_low": 70,          "reference_high": 100,          "loinc_code": "2345-7",          "panel": "BMP",          "interpretation": "high",          "flag": "H",          "plausibility": "plausible",          "confidence": 0.95,          "needs_review": true        }      ]    }  ],  "summary": {    "total_tests": 2,    "flagged": 1,    "needs_review": 1  },  "metadata": {    "engine": "primary",    "processing_time_ms": 1243,    "confidence_mean": 0.96  }}

Obtén la salida FHIR

Si tu sistema consume FHIR R4, usa el endpoint /v1/lab/fhir en su lugar. Devuelve un Bundle FHIR estándar con recursos Patient y Observation, listo para la integración con cualquier HCE compatible con FHIR.

Bash

curl -X POST https://api.medextract.ai/v1/lab/fhir \  -H "X-API-Key: your-api-key" \  -F "file=@lab-report.pdf"

Respuesta FHIR R4 Bundle

{  "resourceType": "Bundle",  "type": "collection",  "entry": [    {      "resource": {        "resourceType": "Patient",        "name": [{ "text": "Juan Garcia" }],        "gender": "male",        "birthDate": "1981-01-01"      }    },    {      "resource": {        "resourceType": "Observation",        "status": "final",        "code": {          "coding": [            {              "system": "http://loinc.org",              "code": "718-7",              "display": "Hemoglobin"            }          ],          "text": "Hemoglobina"        },        "valueQuantity": {          "value": 14.2,          "unit": "g/dL",          "system": "http://unitsofmeasure.org",          "code": "g/dL"        },        "interpretation": [          {            "coding": [              {                "system": "http://hl7.org/fhir/v3/ObservationInterpretation",                "code": "N",                "display": "Normal"              }            ]          }        ]      }    }  ]}

Siguientes pasos

Ahora que has hecho tu primera solicitud, explora la API completa.

Referencia de endpoints API Volver a la documentación

{ "patient": { "name": "Juan Garcia", "age": 45, "sex": "M", "date": "2026-02-20" }, "sections": [ { "name": "Hematologia", "results": [ { "test_name": "Hemoglobina", "test_name_en": "Hemoglobin", "value": "14.2", "numeric_value": 14.2, "unit": "g/dL", "unit_ucum": "g/dL", "reference_range": "13.0 - 17.0", "reference_low": 13.0, "reference_high": 17.0, "loinc_code": "718-7", "panel": "CBC", "interpretation": "normal", "flag": null, "plausibility": "plausible", "confidence": 0.97, "needs_review": false }, { "test_name": "Glucosa", "test_name_en": "Glucose", "value": "126", "numeric_value": 126, "unit": "mg/dL", "unit_ucum": "mg/dL", "reference_range": "70 - 100", "reference_low": 70, "reference_high": 100, "loinc_code": "2345-7", "panel": "BMP", "interpretation": "high", "flag": "H", "plausibility": "plausible", "confidence": 0.95, "needs_review": true } ] } ], "summary": { "total_tests": 2, "flagged": 1, "needs_review": 1 }, "metadata": { "engine": "primary", "processing_time_ms": 1243, "confidence_mean": 0.96 }}

{ "resourceType": "Bundle", "type": "collection", "entry": [ { "resource": { "resourceType": "Patient", "name": [{ "text": "Juan Garcia" }], "gender": "male", "birthDate": "1981-01-01" } }, { "resource": { "resourceType": "Observation", "status": "final", "code": { "coding": [ { "system": "http://loinc.org", "code": "718-7", "display": "Hemoglobin" } ], "text": "Hemoglobina" }, "valueQuantity": { "value": 14.2, "unit": "g/dL", "system": "http://unitsofmeasure.org", "code": "g/dL" }, "interpretation": [ { "coding": [ { "system": "http://hl7.org/fhir/v3/ObservationInterpretation", "code": "N", "display": "Normal" } ] } ] } } ]}