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.