Crear composición
Cree la composición mediante FHIR R4 4.0.1.
Recurso category: composición.
Punto final
| Método | Punto final |
|---|---|
POST | /api/fhir/r4/Composition |
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 |
|---|---|---|---|---|
Composition | Cuerpo de solicitud JSON | Sí | FHIR R4 Composición | Proporcione un recurso completo válido. El servidor asigna el ID de recurso creado. |
Autorización
| Contexto | Ámbito de recurso |
|---|---|
| Definición de servidor de recursos/token emitido | system/Composition.c |
| Solicitud de token/otorgamiento de cliente | ddfssystem/Composition.c |
Se siguen aplicando restricciones de recursos. Utilice el privilegio mínimo necesario para esta operación; consulte authentication and scope configuration.
Comportamiento
Crear un recurso de composición con un ID asignado por el servidor. Utilice los metadatos de ID, versión y Location, ETag y Last-Modified devueltos en solicitudes posteriores.
- Ciclo de vida de los recursos: 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.
POST /api/fhir/r4/Composition
Content-Type: application/fhir+json
{
"resourceType": "Composition",
"identifier": {
"system": "urn:example:composition",
"value": "synthetic-report"
},
"status": "final",
"type": {
"coding": [
{
"system": "http://loinc.org",
"code": "11502-2"
}
]
},
"subject": {
"reference": "Patient/p"
},
"date": "2026-10-22T10:00:00Z",
"author": [
{
"reference": "Practitioner/author"
}
],
"title": "Synthetic genetic report"
}
Respuestas
| Estado correcto | Significado |
|---|---|
| 201 | Recurso creado; el contenido de la respuesta sigue la preferencia de devolución admitida. |
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.