Documentación Técnica

API FHIR R4

Integre sus sistemas con UNICO usando el estándar internacional HL7 FHIR R4. Documentación completa, ejemplos y SDKs disponibles.

HL7 FHIR R4REST APIJSONOAuth 2.0

Inicio Rápido

Base URL
https://api.unico.com.ve/fhir/r4
1

Obtener credenciales

Solicite su Client ID y Secret en el portal de desarrolladores.

2

Autenticarse

Use OAuth 2.0 Client Credentials para obtener un access token.

3

Hacer requests

Incluya el token en el header Authorization: Bearer.

Endpoints Principales

MétodoEndpointDescripción
GET/fhir/Patient/{id}Obtener paciente por ID
POST/fhir/PatientCrear nuevo paciente
GET/fhir/DiagnosticReportBuscar resultados
POST/fhir/DiagnosticReportEnviar resultado de laboratorio
GET/fhir/ObservationBuscar observaciones
GET/fhir/Practitioner/{id}Obtener datos del médico

Recursos FHIR Soportados

Patient

Información demográfica del paciente

Ejemplo JSON
{
  "resourceType": "Patient",
  "id": "ejemplo-paciente",
  "identifier": [{
    "system": "urn:oid:2.16.840.1.113883.4.6",
    "value": "V-12345678"
  }],
  "name": [{
    "family": "García",
    "given": ["María", "José"]
  }],
  "gender": "female",
  "birthDate": "1985-03-15"
}

DiagnosticReport

Resultados de laboratorio y estudios

Ejemplo JSON
{
  "resourceType": "DiagnosticReport",
  "id": "resultado-lab-001",
  "status": "final",
  "code": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "58410-2",
      "display": "CBC panel"
    }]
  },
  "subject": {
    "reference": "Patient/ejemplo-paciente"
  },
  "effectiveDateTime": "2024-12-10T10:30:00Z",
  "issued": "2024-12-10T14:00:00Z"
}

Observation

Observaciones clínicas y signos vitales

Ejemplo JSON
{
  "resourceType": "Observation",
  "status": "final",
  "category": [{
    "coding": [{
      "system": "http://terminology.hl7.org/CodeSystem/observation-category",
      "code": "vital-signs"
    }]
  }],
  "code": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "8867-4",
      "display": "Heart rate"
    }]
  },
  "valueQuantity": {
    "value": 72,
    "unit": "beats/minute",
    "system": "http://unitsofmeasure.org",
    "code": "/min"
  }
}

¿Necesita ayuda con la integración?

Nuestro equipo de soporte técnico está disponible para asistirle en el proceso de integración y resolver cualquier duda.

Contactar Soporte TécnicoEspecificación FHIR Oficial