Escenario: Gestión del ciclo de vida de muestras
Cree, busque, lea, lea versiones, actualice y elimine recursos de muestra FHIR R4, con operaciones de supresión permanente autorizadas por separado.
Autorización
Utilice un token de acceso OAuth 2.0 emitido por los dominios de identidad de OCI con los ámbitos de recursos DDFS necesarios para cada interacción de muestra. Las operaciones de supresión permanente requieren su autorización documentada por separado. Configure el cliente y obtenga tokens siguiendo Crear una aplicación integrada y Referencia de autenticación de DDFS.
Interacciones anunciadas
La declaración de capacidad R4 anuncia interacciones de creación, lectura, lectura de versiones, actualización, eliminación y búsqueda de tipo para muestras:
POST /api/fhir/r4/Specimen
GET /api/fhir/r4/Specimen/{rid}
GET /api/fhir/r4/Specimen/{rid}/_history/{vid}
PUT /api/fhir/r4/Specimen/{rid}
DELETE /api/fhir/r4/Specimen/{rid}
GET /api/fhir/r4/Specimen
Crear y actualizar una muestra
La siguiente carga útil abreviada base-FHIR R4 es una ilustración. Proporcione el contenido requerido por los perfiles y el flujo de trabajo de laboratorio seleccionados para la aplicación.
(application/fhir+json)
POST {base}/api/fhir/r4/Specimen
Content-Type: application/fhir+json
{
"resourceType": "Specimen",
"status": "available",
"subject": {
"reference": "Patient/{patient_id}"
},
"type": {
"text": "Blood specimen"
}
}
Para conocer los requisitos de carga útil y solicitud de actualización, consulte PUT /api/fhir/r4/Specimen/{rid}.
Buscar muestra
La superficie de búsqueda de muestras R4 anuncia patient, además de _id, _lastUpdated, _profile, _tag, _count y _total. Busque por referencia directa del paciente o con el modificador :identifier:
GET {base}/api/fhir/r4/Specimen?patient=Patient/{patient_id}
GET {base}/api/fhir/r4/Specimen?patient:identifier={system}|{value}
El parámetro _lastUpdated acepta los comparadores de fechas anunciados. Un rango puede utilizar un máximo de dos parámetros repetidos. No combine valores de fecha con una coma.
GET {base}/api/fhir/r4/Specimen?_lastUpdated=ge2026-01-01T00:00:00Z&_lastUpdated=le2026-01-31T23:59:59Z
Utilice el parámetro _count anunciado al solicitar un tamaño de página.
Depurar recursos suprimidos anteriormente por tipo
La operación $purgeDeleted anunciada es de nivel de tipo:
POST {base}/api/fhir/r4/Specimen/$purgeDeleted
Content-Type: application/fhir+json
Su entrada de parámetros FHIR necesita un valor before de tipo dateTime. Opcionalmente, acepta un entero limit del 1 al 50.
(application/fhir+json)
{
"resourceType": "Parameters",
"parameter": [
{
"name": "before",
"valueDateTime": "2026-01-01T00:00:00Z"
},
{
"name": "limit",
"valueInteger": 25
}
]
}
La definición de operación necesita una salida OperationOutcome.
Supresión definitiva de un recurso suprimido
La operación $hardDelete anunciada es de nivel de instancia y se dirige a una muestra suprimida:
POST {base}/api/fhir/r4/Specimen/{rid}/$hardDelete
La definición de operación necesita una salida OperationOutcome.
La supresión permanente no se puede deshacer. Siga las operaciones de supresión y depuración de datos antes de llamar a cualquiera de las operaciones de supresión permanente.