API de Interoperabilidad en Salud – Ayudas Diagnósticas
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 resultados de ayudas diagnósticas (laboratorios, imágenes, estudios especiales) de forma segura, estandarizada y trazable en el repositorio FHIR de Sura.
¿Qué ofrece esta API?
| Capacidad | Descripción |
|---|---|
| 🔬 Ayudas Diagnósticas | Ingesta de resultados de laboratorio, imágenes diagnósticas y estudios especiales 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: DiagnosticReport, Observation, ImagingStudy, Specimen, 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 preparan los resultados diagnósticos del paciente (laboratorios, imágenes y estudios especiales) listos para transmitir. | 3 Los resultados se envían a la plataforma, que confirma su recepción y almacenamiento de forma exitosa. |
Beneficios
Centraliza los resultados de laboratorio, imágenes diagnósticas y estudios especiales en un único repositorio estándar e interoperable. | Facilita la toma de decisiones clínicas al poner disponibles todos los resultados diagnósticos en formato 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 ayudas diagnósticas. |
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 conjunto completo de resultados diagnósticos. |
| 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. |
| Ayudas Diagnósticas | Conjunto de exámenes y estudios ordenados para apoyar el diagnóstico clínico: laboratorios, imágenes diagnósticas, electrocardiogramas, espirometrías, entre otros. |
| DiagnosticReport | Recurso FHIR que representa el informe de un examen diagnóstico, incluyendo sus hallazgos, interpretación y referencias a observaciones. |