Escenario: Supresión, Depuración Suprimida y Supresión Fija

Cómo utilizar la supresión lógica, la depuración de nivel de recopilación de recursos suprimidos y las operaciones de supresión definitiva de nivel de instancia.

Antes de empezar

DDFS no admite SMART en los flujos de trabajo de inicio o autorización de FHIR. 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 la solicitud. Configure el cliente y el token siguiendo los pasos de Creación de una aplicación integrada y Referencia de autenticación de DDFS.

  • Para una supresión estándar, utilice un token de acceso con autoridad de supresión coincidente para el recurso FHIR de destino.
  • Para $hardDelete o $purgeDeleted, utilice un token de acceso con la autoridad de supresión coincidente y el ámbito de supresión permanente personalizado. Consulte Configure Custom Hard-Delete Authorization.

Descripción general

Esta API admite tres operaciones diferentes para suprimir recursos de FHIR:

  • Supresión estándar (instancia): suprime de forma lógica una instancia de recurso específica.
  • Depurar suprimido (recopilación): elimina permanentemente los recursos suprimidos anteriormente en una recopilación.
  • Supresión física (instancia): elimina permanentemente una instancia de recurso suprimida específica y devuelve un valor OperationOutcome que describe el resultado.

Supresión estándar (instancia)

Utilice la supresión estándar cuando necesite suprimir de forma lógica una instancia de recurso específica.

DELETE /api/fhir/{r4|r6-ballot4}/<Resource>/{rid}

Puntos finales R4

Puntos finales de R6

Depurar suprimido (recopilación)

Use la depuración de tomas solo si está definida para el recurso. Esta operación elimina permanentemente los recursos que ya están en un estado estándar suprimido dentro de la recopilación específica.

POST /api/fhir/{r4|r6-ballot4}/<Resource>/$purgeDeleted

Comportamiento del servidor

Envíe before y opcional limit en un cuerpo de solicitud de FHIR Parameters:

POST /api/fhir/{r4|r6-ballot4}/<Resource>/$purgeDeleted
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    { "name": "before", "valueDateTime": "2026-01-01T00:00:00Z" },
    { "name": "limit", "valueInteger": 25 }
  ]
}
  • Requiere autorización elevada.
  • Restringe la depuración a los recursos que ya están en estado suprimido.
  • Requiere before como corte de FHIR dateTime; los recursos suprimidos antes de ese instante son elegibles para la depuración.
  • Acepta un entero limit opcional del 1 al 50.
  • Devuelve un valor OperationOutcome que describe el resultado.

Puntos finales R4

Puntos finales de R6

Supresión permanente (instancia)

Utilice la supresión estricta para eliminar permanentemente una instancia de recurso suprimida específica y devolver un OperationOutcome que describa el resultado. Esta operación se modela como POST /{rid}/$hardDelete para los recursos soportados.

POST /api/fhir/{r4|r6-ballot4}/<Resource>/{rid}/$hardDelete

Puntos finales R4

Puntos finales de R6

Solicitud y respuesta

  • La autenticación y la autorización son necesarias. Asegúrese de que el usuario tiene privilegios para realizar una supresión administrativa.
  • Las solicitudes tienen como destino el punto final de recopilación de recursos ($purgeDeleted) o una instancia de recurso específica {rid} con $hardDelete.
  • Las respuestas devuelven un cuerpo OperationOutcome que describe el resultado.

Para obtener la lista completa de puntos finales, consulte FHIR Endpoints.

Códigos de Estado

CódigoSignificado
200Se completó la operación de depuración o eliminación definitiva y se devolvió un OperationOutcome.
204La solicitud de supresión estándar se ha completado correctamente y la respuesta no tiene cuerpo.