Integración para Desarrolladores

API REST e Interoperabilidad HL7

Aprende a conectar expedientes clínicos electrónicos, sistemas hospitalarios (HIS) y analizadores directamente con la base de datos de ReactLab LIS.

Autenticación por API Key

Todas las llamadas HTTP deben incluir el encabezado `Authorization: Bearer YOUR_API_KEY`. La conexión se realiza de forma segura mediante encriptación TLS 1.3 de extremo a extremo.

Endpoints de la API REST

POST/api/v1/orders

Crea una nueva orden de estudio en el laboratorio a partir de un sistema externo (EMR, Clínica o Expediente Médico).

Cuerpo de la Petición (Request Body)

{
  "patient": {
    "name": "Juan Pérez",
    "email": "juan.perez@mail.com",
    "gender": "M",
    "birthDate": "1988-05-12"
  },
  "tests": ["GLU", "COL", "TRI"],
  "referringDoctor": "Dr. Arturo Pérez"
}

Respuesta de Servidor (JSON Response)

{
  "status": "success",
  "orderId": "ORD-2026-98721",
  "qrCode": "https://molecularlabs.cloud/q/ORD-2026-98721",
  "createdAt": "2026-07-27T22:15:00Z"
}

GET/api/v1/results/ORD-2026-98721

Recupera los resultados de análisis clínicos validados y firmados digitalmente asociados a una orden específica.

Respuesta de Servidor (JSON Response)

{
  "orderId": "ORD-2026-98721",
  "status": "validated",
  "responsibleDoctor": {
    "name": "Dr. Arturo Pérez",
    "license": "7728394-A"
  },
  "results": [
    { "code": "GLU", "name": "Glucosa", "value": "142", "unit": "mg/dL", "reference": "70 - 100", "status": "abnormal" },
    { "code": "COL", "name": "Colesterol Total", "value": "210", "unit": "mg/dL", "reference": "150 - 200", "status": "abnormal" }
  ],
  "pdfUrl": "https://molecularlabs.cloud/reports/ORD-2026-98721.pdf"
}

Mensajería Estándar HL7 v2.x

ReactLab LIS admite integraciones nativas basadas en mensajes TCP/IP MLLP o HTTP para interoperabilidad hospitalaria.

Segmento Demográfico PID

Utilizado para mapear y registrar la identidad del paciente (Nombre, CURP, fecha de nacimiento, sexo) de forma coordinada con el HIS hospitalario.

PID|1||10928372||PEREZ^JUAN||19880512|M|||||

Segmento de Resultados OBX

Contiene la información detallada de cada estudio individual analizado: clave del examen (LOINC), valor numérico, unidades de referencia clínicas y estatus de anomalía.

OBX|1|NM|1558-6^Glucosa||142|mg/dL|70-100|H|||F||