Escenario: Dispositivo de acceso y datos del paciente

Utilice las búsquedas y lecturas de FHIR R4 anunciadas para recuperar los datos de dispositivo, paciente y observación para una integración de dispositivos.

Elige la superficie de la API

Recupere CapabilityStatement de la versión de API que utilizará la aplicación. Confirme los recursos, las interacciones y los parámetros de búsqueda necesarios antes de enviar solicitudes de datos. Este flujo de trabajo utiliza las superficies anunciadas Paciente, Dispositivo, Observación y Procedencia de FHIR R4.

Autorización

Utilice un token de acceso OAuth 2.0 emitido por los dominios de identidad de OCI con los ámbitos de recursos DDFS necesarios para cada solicitud de paciente, dispositivo, observación o procedencia. Configure el cliente y obtenga tokens siguiendo Crear una aplicación integrada y Referencia de autenticación de DDFS.

Recuperar pacientes

Busque al paciente con un parámetro anunciado, como identifier o name, o lea un recurso conocido por su ID lógico.


GET {base}/api/fhir/r4/Patient?identifier={system}|{value}
GET {base}/api/fhir/r4/Patient/{patient_id}
      

Buscar dispositivos

R4 La búsqueda de dispositivos anuncia patient, status, type, manufacturer y model, además de los parámetros comunes anunciados. Busque por referencia directa del paciente o con el modificador :identifier. Los parámetros de cadena manufacturer y model aceptan el modificador :exact.


GET {base}/api/fhir/r4/Device?patient=Patient/{patient_id}
GET {base}/api/fhir/r4/Device?patient:identifier={system}|{value}
GET {base}/api/fhir/r4/Device?manufacturer:exact={manufacturer}
GET {base}/api/fhir/r4/Device?model:exact={model}
      

Para recuperar recursos de proveniencia cuyo destino es un dispositivo coincidente, utilice la reversión anunciada que incluye:


GET {base}/api/fhir/r4/Device?_id={device_id}&_revinclude=Provenance:target
      

Recuperar observaciones de dispositivo

Busque la observación R4 con los parámetros anunciados, incluidos device, patient, category, code, date, encounter, specimen y status. Las siguientes solicitudes utilizan un filtro a la vez para que cada dependencia sea explícita:


GET {base}/api/fhir/r4/Observation?device=Device/{device_id}
GET {base}/api/fhir/r4/Observation?patient=Patient/{patient_id}
GET {base}/api/fhir/r4/Observation?code={system}|{code}
GET {base}/api/fhir/r4/Observation?date=ge2026-01-01&date=le2026-01-31
      

Un rango de fechas no utiliza más de dos parámetros date repetidos con comparadores anunciados. No combine valores de fecha con una coma.

Solicitar un tamaño de página

Utilice el parámetro _count anunciado al solicitar un tamaño de página.


GET {base}/api/fhir/r4/Device?status=active&_count={page_size}
      

Flujo de trabajo de suscripción opcional R6

Si la aplicación selecciona la API R6 y requiere interacciones de SubscriptionTopic o SubscriptionTopic anunciadas por su CapabilityStatement, siga las suscripciones de FHIR R6. Ese flujo de trabajo dedicado define los recursos, las entradas y las consideraciones operativas aplicables.

Referencias