API de Interoperabilidad en Salud – Historia Clínica
Versión: 1.0.0 | Estándar: FHIR R4 (HL7) | Protocolo: HTTPS (TLS) | Formato: JSON / FHIR+JSON | Autenticación: OAuth 2.0 – Client Credentials
Plataforma de intercambio clínico basada en el estándar internacional FHIR R4 (HL7). Permite a las organizaciones de salud transmitir y persistir documentos de historia clínica de pacientes de manera segura, estandarizada y trazable en el repositorio FHIR de Sura.
¿Qué ofrece esta API?
| Capacidad | Descripción |
|---|---|
| 🏥 Historia Clínica Electrónica | Ingesta de documentos clínicos del paciente (diagnósticos, medicamentos, procedimientos, laboratorios) agrupados en un Bundle FHIR R4. |
| 🔐 Seguridad OAuth 2.0 | Acceso controlado mediante tokens Bearer de corta duración. Solo sistemas autorizados con credenciales válidas pueden consumir los recursos. |
| 📦 Documentos Clínicos FHIR | Envío de paquetes (Bundle) que agrupan múltiples recursos: Patient, Encounter, Condition, MedicationRequest, Observation, entre otros. |
| 🌐 Cloud Healthcare | Respaldada por Google Cloud Healthcare API, garantizando alta disponibilidad, trazabilidad y cumplimiento normativo (Resolución 866 de 2021). |
¿Cómo funciona?
1 El sistema se autentica con sus credenciales para obtener un permiso de acceso temporal. | 2 Se prepara el documento clínico del paciente con toda la información del episodio de atención. | 3 El documento se envía a la plataforma, que confirma su recepción y almacenamiento de forma exitosa. |
Beneficios
Centraliza la historia clínica electrónica del paciente en un repositorio estándar, eliminando la fragmentación de información entre sistemas. | Garantiza interoperabilidad con sistemas de salud nacionales e internacionales gracias al estándar HL7 FHIR R4. |
Reduce tiempos y costos de integración con una API REST moderna, segura y con autenticación OAuth 2.0. | Cumple con la normativa colombiana MINSALUD y la Resolución 866 de 2021 para historia clínica electrónica. |
Glosario de Términos Clave
| Término | Significado |
|---|---|
| FHIR R4 | Estándar internacional para intercambio de información clínica (Fast Healthcare Interoperability Resources, v4). Publicado por HL7. |
| Bundle | Contenedor FHIR que agrupa múltiples recursos en un solo paquete. Equivale a un "sobre" con el documento clínico completo. |
| OAuth 2.0 | Protocolo estándar de autorización. Permite acceso sin compartir contraseñas, usando tokens temporales. |
| Bearer Token | Credencial temporal de acceso. Válida por período limitado. Debe tratarse con la misma confidencialidad que una contraseña. |
| Client Credentials | Flujo OAuth para comunicación entre sistemas (machine-to-machine), sin intervención de usuario final. |
| Data Provider | Entidad o sistema que genera y envía información clínica hacia la plataforma de interoperabilidad. Se identifica con el encabezado X-Request-Data-Provider. |
| Historia Clínica | Registro longitudinal de los eventos de salud de un paciente: consultas, diagnósticos, medicamentos, procedimientos y resultados de laboratorio. |