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/r4y/api/fhir/r6-ballot4, según la familia de recursos admitida. - La interacción FHIR
metadatasigue 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/tokeno/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
ddfsorientado al cliente, comosystem/Device.rs. - Los permisos de aplicación cliente y las solicitudes de token utilizan el formato fijo con prefijo
ddfs, comoddfssystem/Device.rs. El token emitido contiene el ámbito canónico correspondiente, comosystem/Device.rs. - La validación de token comprueba la reclamación
auddel 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 ámbitosuser/...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.
$hardDeleteelimina permanentemente un recurso suprimido y$purgeDeletedelimina permanentemente los recursos suprimidos elegibles de un tipo solicitado.- Para
$purgeDeleted, envíebeforeylimitopcional en un cuerpo de solicitud de FHIRParametersutilizandovalueDateTimeyvalueInteger. - 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.dyddfshttps://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete. El token emitido contienesystem/Patient.dyhttps://docs.oracle.com/iaas/device-data-fhir/scopes/hard-delete.