Actualizar composición
Actualice la composición con FHIR R4 4.0.1.
Recurso category: composición.
Punto final
| Método | Punto final |
|---|---|
PUT | /api/fhir/r4/Composition/{rid} |
Utilice la URL base R4 de la instancia de DDFS. Envíe Authorization: Bearer <access-token> y acepte application/fhir+json.
Envíe Content-Type: application/fhir+json.
Parámetros
| Parámetro | Ubicación | Necesario | Tipo | Descripción |
|---|---|---|---|---|
rid | Ruta | Sí | ID lógico de FHIR | ID lógico del recurso de composición. |
Composition | Cuerpo de solicitud JSON | Sí | FHIR R4 Composición | Proporcione un recurso completo válido cuyo ID de cuerpo coincida con el de deshecho. |
If-Match | Encabezado | Nº | ETag | Al utilizar una condición previa de versión, envíe el ETag actual. Una versión obsoleta se rechaza con HTTP 412; consulte orientación sobre el ciclo de vida de los recursos. |
Autorización
| Contexto | Ámbito de recurso |
|---|---|
| Definición de servidor de recursos/token emitido | system/Composition.u |
| Solicitud de token/otorgamiento de cliente | ddfssystem/Composition.u |
PUT creación/restauración: token emitido | system/Composition.cu |
PUT creación/restauración — concesión de cliente | ddfssystem/Composition.cu |
Se siguen aplicando restricciones de recursos. Utilice el privilegio mínimo necesario para esta operación; consulte authentication and scope configuration.
Comportamiento
Sustituya el recurso de composición dirigido. Una PUT como creación o restauración admitida devuelve 201; la actualización de un recurso activo devuelve 200. La restauración conserva el historial y continúa la numeración de versiones. El ID de cuerpo debe coincidir con el ID de URL. Una solicitud If-Match obsoleta no aplica la actualización.
- PUT como creación y restauración: semántica de operación compartida.
- Orientación de recursos de composición: requisitos y restricciones específicos del recurso.
- R4 CapabilityStatement y metadatos R4: capacidades soportadas.
Ejemplo de solicitud
Sustituya los ID lógicos de ejemplo, los ID de versión y los valores de conexión por valores para el flujo de trabajo.
PUT /api/fhir/r4/Composition/{rid}
Content-Type: application/fhir+json
If-Match: W/"<current-version>"
Respuestas
| Estado correcto | Significado |
|---|---|
| 200 | Se actualizó el recurso activo. |
| 201 | Recurso creado o restaurado mediante el comportamiento PUT-as-create soportado. |
Para conocer los estados de error comunes y los cuerpos de error con formato FHIR, consulte OperationOutcome errors. Las respuestas de autenticación/autorización siguen la política compartida; un recurso protegido se puede ocultar como 404. Consulte también respuestas de interacción.
Las preferencias de devolución Prefer soportadas controlan el contenido de la respuesta; las cabeceras Location, ETag y Last-Modified aplicables siguen el contrato de ciclo de vida.
Definición de FHIR
Definición de FHIR R4: https://hl7.org/fhir/R4/composition.html. Perfil canónico URI: http://hl7.org/fhir/StructureDefinition/Composition.