Interoperabilidad R4 y R6
Elija la versión de DDFS FHIR que admita su recurso y flujo de trabajo, y mantenga las solicitudes en la ruta base de API con versiones correspondiente.
Descripción general
DDFS proporciona una superficie de API FHIR R4 (4.0.1) y una superficie de API FHIR R6 ballot4 (6.0.0-ballot4). Las superficies de la API son específicas de la versión; un recurso creado en una superficie se dirige a través de la misma ruta base versionada.
Utilice el CapabilityStatement devuelto por el punto final de metadatos para la instancia de DDFS desplegada como autoridad para los recursos, interacciones, operaciones, formatos y parámetros de búsqueda que anuncia la instancia. Compruébelo durante la configuración de integración y después de una actualización de servicio.
Los ejemplos utilizan estos marcadores de posición para las URL base de la API de FHIR específicas de la versión:
{r4-api-base}:https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r4{r6-api-base}:https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4
Los puntos finales de metadatos permiten solicitudes anónimas. No se necesita ningún token de acceso ni cabecera Authorization.
GET {r4-api-base}/metadata
Accept: application/fhir+json
GET {r6-api-base}/metadata
Accept: application/fhir+json
Modelo de interoperabilidad
Un cliente comprueba la sentencia de capacidad, selecciona la ruta base con versiones coincidente y utiliza solo las capacidades anunciadas para esa versión. La lógica de cliente compartida puede manejar formularios de respuesta FHIR comunes, incluidos los resultados de búsqueda Bundle, los errores OperationOutcome y el contenido application/fhir+json.
Diferencias clave
- Ruta base: las solicitudes R4 utilizan
/api/fhir/r4. Las solicitudes R6 utilizan/api/fhir/r6-ballot4. - Liberación de FHIR: la superficie R4 utiliza FHIR R4 (4.0.1). La superficie R6 utiliza la boleta FHIR R64 (6.0.0-ballot4).
- Cobertura de recursos: revise los recursos R4 de FHIR y los recursos R6 de FHIR y, a continuación, confirme la sentencia de capacidad desplegada.
- Flujos de trabajo de R6: los recursos como DeviceAssociation, Suscription y SubscriptionTopic se documentan en la superficie de la API de R6.
- Comportamiento de búsqueda: el parámetro, el comparador, el modificador, la cadena, la inclusión y el soporte de inclusión inversa pueden variar según el recurso y la versión.
Búsqueda de la ruta base correcta para la instancia de DDFS
- Abra el menú de navegación, seleccione Developer Services y, a continuación, seleccione Device Data FHIR Service.
- En la página de lista Instancias de DDFS, seleccione la instancia con la que desea trabajar.
- En la página de detalles de la instancia, busque Developer Integration.
- Copie la URL base de la API de FHIR R4 o la URL base de la API de FHIR R6 que necesita su flujo de trabajo.
Utilice este comando y los parámetros necesarios para obtener información sobre una instancia de DDFS:
oci ddfs instance get --instance-id <instance-OCID>Utilice el punto final de servicio de FHIR devuelto con la ruta de la versión R4 o R6 ballot4 que se muestra en la visión general.
Para obtener una lista completa de los parámetros y valores de este comando de la CLI, consulte Referencia de comandos de la CLI.
Ejecute la operación GetInstance para obtener información sobre una instancia de DDFS.
Utilice el punto final de servicio de FHIR devuelto con la ruta de la versión R4 o R6 ballot4 que se muestra en la visión general.
- Llame a
GET {r4-api-base}/metadataoGET {r6-api-base}/metadatapara obtener la versión que está considerando. - Busque el recurso necesario en
CapabilityStatement.rest.resource. - Confirme los parámetros de interacción, operación, formato y búsqueda necesarios en esa entrada de recurso.
- Envíe la solicitud de recurso a la misma ruta de acceso base con versiones que la solicitud de metadatos.
- Mantenga la versión seleccionada en la configuración del cliente para que un cambio de versión sea deliberado y comprobable.
Si no se anuncia una capacidad necesaria, no la infiera de otra versión de FHIR. Seleccione un flujo de trabajo alternativo documentado o póngase en contacto con el administrador de DDFS.
- Llame a
Ejemplos
Los siguientes ejemplos recuperan ambas sentencias de capacidad y comparan los tipos de recursos anunciados. Las solicitudes de metadatos no necesitan un token de acceso ni una cabecera Authorization. La solicitud de búsqueda de paciente protegida en el ejemplo curl requiere un token de acceso de portador de OAuth 2.0 con permiso de búsqueda de paciente. Al configurar la solicitud de token y permiso de cliente, utilice ddfssystem/Patient.s para el acceso de solo búsqueda o ddfssystem/Patient.rs para el acceso de búsqueda y lectura del paciente.
Autorización y errores
- Las solicitudes de metadatos no requieren autorización. Para solicitudes de recursos de FHIR protegidas, utilice un token de acceso de portador de OAuth 2.0 emitido por los dominios de identidad de OCI. No se admite SMART en los flujos de trabajo de inicio y autenticación FHIR.
- Para la configuración del cliente OAuth, consulte Creación de aplicaciones integradas para OAuth de DDFS. Para obtener orientación sobre el ámbito, consulte Referencia de autenticación de DDFS.
- Manejar errores con formato FHIR como recursos
OperationOutcome. Consulte Referencia de OperationOutcome.
Referencias
Recupere la sentencia de capacidad FHIR R4 (4.0.1):
curl -sS -H "Accept: application/fhir+json" \ "{r4-api-base}/metadata"Recupere la sentencia de capacidad FHIR R6 ballot4 (6.0.0-ballot4):
curl -sS -H "Accept: application/fhir+json" \ "{r6-api-base}/metadata"Después de confirmar el soporte, envíe la solicitud a la superficie de API correspondiente:
curl -sS -H "Authorization: Bearer <access-token>" \ -H "Accept: application/fhir+json" \ "{r4-api-base}/Patient?identifier=http%3A%2F%2Fhospital.example.org%2Fmrn%7C123456"Recupere las sentencias de capacidad y muestre los recursos anunciados por cada versión:
$metadataHeaders = @{ Accept = "application/fhir+json" } $r4 = Invoke-RestMethod -Headers $metadataHeaders -Method Get -Uri "{r4-api-base}/metadata" $r6 = Invoke-RestMethod -Headers $metadataHeaders -Method Get -Uri "{r6-api-base}/metadata" $r4.rest.resource.type | Sort-Object $r6.rest.resource.type | Sort-ObjectCompruebe si un recurso se anuncia en cualquier superficie:
$resource = "Subscription" [pscustomobject]@{ Resource = $resource R4 = $r4.rest.resource.type -contains $resource R6 = $r6.rest.resource.type -contains $resource }