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.

Advertencia

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.

Referencias