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
$hardDeleteo$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
OperationOutcomeque 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
- DELETE /api/fhir/r4/Condition/{rid} – Consulte DELETE Condition by ID.
- DELETE /api/fhir/r4/Device/{rid} – Consulte DELETE Device by ID.
- DELETE /api/fhir/r4/DiagnosticReport/{rid} – Consulte DELETE DiagnosticReport by ID.
- DELETE /api/fhir/r4/Encounter/{rid} – Consulte DELETE Encounter by ID.
- DELETE /api/fhir/r4/Endpoint/{rid} – Consulte DELETE Endpoint by ID.
- DELETE /api/fhir/r4/Group/{rid} – Consulte DELETE Group by ID.
- DELETE /api/fhir/r4/Location/{rid} – Consulte DELETE Location by ID.
- DELETE /api/fhir/r4/Observation/{rid} – Consulte DELETE Observation by ID.
- DELETE /api/fhir/r4/Organization/{rid} – Consulte DELETE Organization by ID.
- DELETE /api/fhir/r4/Patient/{rid} – Consulte DELETE Patient by ID.
- DELETE /api/fhir/r4/Practitioner/{rid} – Consulte DELETE Practitioner by ID.
- DELETE /api/fhir/r4/PractitionerRole/{rid} – Consulte DELETE PractitionerRole by ID.
- DELETE /api/fhir/r4/Provenance/{rid} – Consulte DELETE Provenance by ID.
- DELETE /api/fhir/r4/RelatedPerson/{rid} – Consulte DELETE Related Person by ID.
- DELETE /api/fhir/r4/ServiceRequest/{rid} – Consulte DELETE ServiceRequest by ID.
- DELETE /api/fhir/r4/Specimen/{rid} – Consulte DELETE Specimen by ID.
Puntos finales de R6
- DELETE /api/fhir/r6-ballot4/DeviceAssociation/{rid} – Consulte DELETE DeviceAssociation by ID.
- DELETE /api/fhir/r6-ballot4/Device/{rid} – Consulte DELETE Device by ID.
- DELETE /api/fhir/r6-ballot4/Encounter/{rid} – Consulte DELETE Encounter by ID.
- DELETE /api/fhir/r6-ballot4/Location/{rid} – Consulte DELETE Location by ID.
- DELETE /api/fhir/r6-ballot4/Observation/{rid} – Consulte DELETE Observation by ID.
- DELETE /api/fhir/r6-ballot4/Patient/{rid} – Consulte DELETE Patient by ID.
- DELETE /api/fhir/r6-ballot4/Practitioner/{rid} – Consulte DELETE Practitioner by ID.
- DELETE /api/fhir/r6-ballot4/PractitionerRole/{rid} – Consulte DELETE PractitionerRole by ID.
- DELETE /api/fhir/r6-ballot4/Provenance/{rid} – Consulte DELETE Provenance by ID.
- DELETE /api/fhir/r6-ballot4/Subscription/{rid} – Consulte DELETE Subscription.
- DELETE /api/fhir/r6-ballot4/SubscriptionTopic/{rid} – Consulte DELETE SubscriptionTopic.
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
beforecomo corte de FHIRdateTime; los recursos suprimidos antes de ese instante son elegibles para la depuración. - Acepta un entero
limitopcional del 1 al 50. - Devuelve un valor
OperationOutcomeque describe el resultado.
Puntos finales R4
- POST /api/fhir/r4/Condition/$purgeDeleted – Consulte Purge Deleted Condition.
- POST /api/fhir/r4/Device/$purgeDeleted – Consulte Purge Deleted Device.
- POST /api/fhir/r4/DiagnosticReport/$purgeDeleted – Consulte Purge Deleted DiagnosticReport.
- POST /api/fhir/r4/Encounter/$purgeDeleted – Consulte Depuración de episodio clínico eliminado.
- POST /api/fhir/r4/Endpoint/$purgeDeleted – Consulte Depuración del punto final suprimido.
- POST /api/fhir/r4/Group/$purgeDeleted – Consulte Depurar Grupo Suprimido.
- POST /api/fhir/r4/Location/$purgeDeleted – Consulte Purge Deleted Location.
- POST /api/fhir/r4/Observation/$purgeDeleted – Consulte Depuración de la observación suprimida.
- POST /api/fhir/r4/Organization/$purgeDeleted – Consulte Depuración de la organización suprimida.
- POST /api/fhir/r4/Patient/$purgeDeleted – Consulte Depurar paciente eliminado.
- POST /api/fhir/r4/Practitioner/$purgeDeleted – Consulte Purge Deleted Practitioner.
- POST /api/fhir/r4/PractitionerRole/$purgeDeleted – Consulte Purge Deleted PractitionerRole.
- POST /api/fhir/r4/Provenance/$purgeDeleted – Consulte Depuración de la procedencia suprimida.
- POST /api/fhir/r4/RelatedPerson/$purgeDeleted – Consulte Depuración de RelatedPerson eliminada.
- POST /api/fhir/r4/ServiceRequest/$purgeDeleted – Consulte Depurar ServiceRequest Suprimida.
- POST /api/fhir/r4/Specimen/$purgeDeleted – Consulte Depuración de muestras eliminadas.
Puntos finales de R6
- POST /api/fhir/r6-ballot4/DeviceAssociation/$purgeDeleted – Consulte Purge Deleted DeviceAssociation.
- POST /api/fhir/r6-ballot4/Device/$purgeDeleted – Consulte Purge Deleted Device.
- POST /api/fhir/r6-ballot4/Encounter/$purgeDeleted – Consulte Depuración de episodio clínico eliminado.
- POST /api/fhir/r6-ballot4/Location/$purgeDeleted – Consulte Purge Deleted Location.
- POST /api/fhir/r6-ballot4/Observation/$purgeDeleted – Consulte Depuración de la observación suprimida.
- POST /api/fhir/r6-ballot4/Patient/$purgeDeleted – Consulte Depurar paciente eliminado.
- POST /api/fhir/r6-ballot4/Practitioner/$purgeDeleted – Consulte Purge Deleted Practitioner.
- POST /api/fhir/r6-ballot4/PractitionerRole/$purgeDeleted – Consulte Purge Deleted PractitionerRole.
- POST /api/fhir/r6-ballot4/Provenance/$purgeDeleted – Consulte Depuración de la procedencia suprimida.
- POST /api/fhir/r6-ballot4/Subscription/$purgeDeleted – Consulte Depuración de la suscripción eliminada.
- POST /api/fhir/r6-ballot4/SubscriptionTopic/$purgeDeleted – Consulte Depuración del tema de suscripción suprimido.
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
- POST /api/fhir/r4/Condition/{rid}/$hardDelete – Consulte Hard Delete Condition.
- POST /api/fhir/r4/Device/{rid}/$hardDelete – Consulte Hard Delete Device.
- POST /api/fhir/r4/DiagnosticReport/{rid}/$hardDelete: consulte Hard Delete DiagnosticReport.
- POST /api/fhir/r4/Encounter/{rid}/$hardDelete: consulte Hard Delete Encounter.
- POST /api/fhir/r4/Endpoint/{rid}/$hardDelete: consulte Hard Delete Endpoint.
- POST /api/fhir/r4/Group/{rid}/$hardDelete – Consulte Hard Delete Group.
- POST /api/fhir/r4/Location/{rid}/$hardDelete – Consulte Hard Delete Location.
- POST /api/fhir/r4/Observation/{rid}/$hardDelete: consulte Hard Delete Observation.
- POST /api/fhir/r4/Organization/{rid}/$hardDelete – Consulte Hard Delete Organization.
- POST /api/fhir/r4/Patient/{rid}/$hardDelete – Consulte Hard Delete Patient.
- POST /api/fhir/r4/Practitioner/{rid}/$hardDelete – Consulte Hard Delete Practitioner.
- POST /api/fhir/r4/PractitionerRole/{rid}/$hardDelete – Consulte Hard Delete PractitionerRole.
- POST /api/fhir/r4/Provenance/{rid}/$hardDelete – Consulte Hard Delete Provenance.
- POST /api/fhir/r4/RelatedPerson/{rid}/$hardDelete – Consulte Hard Delete RelatedPerson.
- POST /api/fhir/r4/ServiceRequest/{rid}/$hardDelete – Consulte Hard Delete ServiceRequest.
- POST /api/fhir/r4/Specimen/{rid}/$hardDelete – Consulte Hard Delete Specimen.
Puntos finales de R6
- POST /api/fhir/r6-ballot4/DeviceAssociation/{rid}/$hardDelete – Consulte Hard Delete DeviceAssociation.
- POST /api/fhir/r6-ballot4/Device/{rid}/$hardDelete – Consulte Hard Delete Device.
- POST /api/fhir/r6-ballot4/Encounter/{rid}/$hardDelete: consulte Hard Delete Encounter.
- POST /api/fhir/r6-ballot4/Location/{rid}/$hardDelete – Consulte Hard Delete Location.
- POST /api/fhir/r6-ballot4/Observation/{rid}/$hardDelete: consulte Hard Delete Observation.
- POST /api/fhir/r6-ballot4/Patient/{rid}/$hardDelete – Consulte Hard Delete Patient.
- POST /api/fhir/r6-ballot4/Practitioner/{rid}/$hardDelete – Consulte Hard Delete Practitioner.
- POST /api/fhir/r6-ballot4/PractitionerRole/{rid}/$hardDelete – Consulte Hard Delete PractitionerRole.
- POST /api/fhir/r6-ballot4/Provenance/{rid}/$hardDelete – Consulte Hard Delete Provenance.
- POST /api/fhir/r6-ballot4/Subscription/{rid}/$hardDelete: consulte Hard Delete Subscription.
- POST /api/fhir/r6-ballot4/SubscriptionTopic/{rid}/$hardDelete – Consulte Hard Delete SubscriptionTopic.
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
OperationOutcomeque describe el resultado.
Para obtener la lista completa de puntos finales, consulte FHIR Endpoints.
Códigos de Estado
| Código | Significado |
|---|---|
| 200 | Se completó la operación de depuración o eliminación definitiva y se devolvió un OperationOutcome. |
| 204 | La solicitud de supresión estándar se ha completado correctamente y la respuesta no tiene cuerpo. |