Escenario: búsqueda del registro de dispositivos y asociaciones

Buscar recursos de dispositivo R4 con filtros anunciados y, cuando se selecciona R6, consultar DeviceAssociation por separado.

Autorización

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

Buscar dispositivo R4

La superficie de búsqueda del dispositivo R4 anuncia patient, status, type, manufacturer y model, además de los parámetros comunes y de control de resultados anunciados.

Buscar por referencia de paciente o identificador de paciente:


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

Buscar por un parámetro de token:


GET {base}/api/fhir/r4/Device?status=active
GET {base}/api/fhir/r4/Device?type={system}|{code}
      

Busque una cadena de modelo o fabricante exacta:


GET {base}/api/fhir/r4/Device?manufacturer:exact={manufacturer}
GET {base}/api/fhir/r4/Device?model:exact={model}
      

Utilice un máximo de dos parámetros _lastUpdated repetidos para un rango, con comparadores anunciados como ge y le. No combine valores de fecha con una coma.


GET {base}/api/fhir/r4/Device?_lastUpdated=ge2026-01-01T00:00:00Z&_lastUpdated=le2026-01-31T23:59:59Z
      

Consulte GET /api/fhir/r4/Device para conocer las definiciones de parámetros y los modificadores permitidos.

Recuperar procedencia relacionada

R4 Device anuncia Provenance:target como un valor de inclusión inversa. Utilícelo para solicitar recursos de proveniencia cuyo destino incluya un dispositivo coincidente:


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

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}
      

Consultar DeviceAssociation R6 por separado

Si la aplicación selecciona R6 y necesita registros de asociación, consulte el recurso DeviceAssociation anunciado por separado. Confirme la interacción del recurso y sus parámetros de búsqueda en R6 CapabilityStatement antes de crear la solicitud.


GET {base}/api/fhir/r6-ballot4/DeviceAssociation?subject=Patient/{patient_id}
      

Interprete Device and DeviceAssociation según la versión de API y el modelo de datos seleccionados por la aplicación del cliente. La aplicación decide si los registros creados a través de diferentes versiones de API se relacionan entre sí y cómo lo hacen.

Referencias