FHIR API

• Estás construyendo un servidor REST compatible con FHIR y necesitas patrones de endpoints correctos, códigos de estado y estructura de CapabilityStatement.
• Estás escribiendo un cliente FHIR y necesitas manejar correctamente ETags, negociación de contenido y respuestas OperationOutcome.
• Estás diseñando rutas de FHIR API y deseas garantizar la alineación con la especificación HL7 antes de escribir código.
• Necesitas implementar lotes o paquetes de transacciones y deseas orientación sobre el formato correcto de solicitud/respuesta.

• Estás trabajando con paradigmas de mensajería o documentos FHIR en lugar del modelo de interacción de la API RESTful.
• Necesitas orientación sobre perfilado FHIR, StructureDefinitions o servicios de terminología, que están fuera del alcance de esta habilidad.

Cubre todas las interacciones REST principales de FHIR API: read, vread, create, update, patch, delete, search, history, capabilities y batch/transaction — con los métodos HTTP correctos, patrones de URL y códigos de estado de éxito.

Explica los tipos MIME de FHIR (application/fhir+json, application/fhir+xml, application/fhir+turtle), el uso adecuado de las cabeceras Accept y Content-Type, la negociación de versiones de FHIR y el parámetro de respaldo _format.

Guía la implementación del seguimiento de versiones basado en ETag mediante encabezados If-Match y explica cómo manejar las respuestas 412 Precondition Failed para realizar actualizaciones concurrentes de forma segura.

Proporciona estructuras de respuesta OperationOutcome correctas y mapea los códigos de estado HTTP específicos de FHIR API (400, 404, 409, 410, 412, 422) a sus casos de uso apropiados.

Explica cómo respetar el encabezado Prefer para return=minimal, return=representation, return=OperationOutcome y patrones de operación asíncrona con 202 Accepted.

Incluye una lista de verificación práctica que cubre CapabilityStatement en /metadata, soporte de ETag, encabezado Location en creación/actualización y el parámetro _format con alternativa de reserva, para ayudar a garantizar el cumplimiento de la especificación.

Construye un servidor REST FHIR API compatible con manejadores de rutas correctos, cabeceras de respuesta y respuestas de error para tipos de recursos como Patient, Observation o DiagnosticReport.

Desarrolla un cliente que construya correctamente solicitudes HTTP de FHIR API, negocie el formato de contenido, gestione versiones de recursos con ETags y analice errores de OperationOutcome.

Implementa lotes o paquetes de transacciones de FHIR publicados en la URL base, gestionando tipos de operaciones mixtas y semántica de transacciones atómicas.

Valida las estructuras de rutas y los mapeos de operaciones planificados en la FHIR API según la especificación HL7 antes de comprometerte con una implementación.