Referencia de documentación de API de FHIR de DDFS

Información de referencia sobre puntos finales de la API de FHIR de DDFS, formularios de ámbito de OAuth y operaciones personalizadas.

Superficie FHIR pública

  • Los recursos de FHIR se exponen en /api/fhir/r4 y /api/fhir/r6-ballot4, según la familia de recursos admitida.
  • La interacción FHIR metadata sigue siendo la superficie de descubrimiento público para la información de capacidad.
  • DDFS no expone los puntos finales de autorización SMART, incluidos /smart/authorize, /smart/token o /api/fhir/{r4,r6-ballot4}/.well-known/smart-configuration.
  • Las suscripciones y SubscriptionTopics están disponibles para FHIR R6.
  • El comportamiento de depuración administrativa personalizada se expone mediante operaciones personalizadas de FHIR, no mediante semántica de supresión de FHIR estándar.

Formularios de ámbito de OAuth

Contexto Forma de ámbito
Definición de servidor de recursos system/...
Solicitud de otorgamiento/token de cliente ddfssystem/...
Reclamación scope del token emitido system/...
  • DDFS utiliza dominios de identidad de OCI para la emisión del token de acceso OAuth y las comprobaciones de JWT/JWKS.
  • El modelo de autorización soportado utiliza ámbitos de OAuth 2.0 emitidos por los dominios de identidad de OCI.
  • Los permisos de recursos de FHIR soportados se definen en el servidor de recursos de DDFS sin el prefijo ddfs orientado al cliente, como system/Device.rs.
  • Los permisos de aplicación cliente y las solicitudes de token utilizan el formato fijo con prefijo ddfs, como ddfssystem/Device.rs. El token emitido contiene el ámbito canónico correspondiente, como system/Device.rs.
  • La validación de token comprueba la reclamación aud del token de acceso independientemente de los ámbitos de recursos de FHIR.
  • DDFS no admite el contexto de inicio SMART, el contexto de paciente SMART, los ámbitos patient/... o los ámbitos user/... para la autorización de recursos de FHIR.

Operaciones administrativas personalizadas

DDFS expone las operaciones personalizadas para eliminar permanentemente los recursos suprimidos:

POST /api/fhir/{r4|r6-ballot4}/{Resource}/{id}/$hardDelete
POST /api/fhir/{r4|r6-ballot4}/{Resource}/$purgeDeleted
  • La supresión de FHIR estándar suprime lógicamente un recurso.
  • $hardDelete elimina permanentemente un recurso suprimido y $purgeDeleted elimina permanentemente los recursos suprimidos elegibles de un tipo solicitado.
  • Para $purgeDeleted, envíe before y limit opcional en un cuerpo de solicitud de FHIR Parameters utilizando valueDateTime y valueInteger.
  • Ambas operaciones requieren el ámbito canónico de supresión permanente de DDFS y un ámbito de supresión de recurso coincidente para el recurso de destino.
  • Ámbitos de otorgamiento/solicitud de token de cliente de ejemplo: ddfssystem/Patient.d y ddfshttps://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete. El token emitido contiene system/Patient.d y https://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete.