FHIR API

• Você está construindo um servidor REST compatível com FHIR e precisa de padrões corretos de endpoint, códigos de status e estrutura de CapabilityStatement.
• Você está escrevendo um cliente FHIR e precisa lidar corretamente com ETags, negociação de conteúdo e respostas OperationOutcome.
• Você está projetando rotas de FHIR API e quer garantir alinhamento com a especificação HL7 antes de escrever o código.
• Você precisa implementar bundles de lote ou transação e quer orientação sobre o formato correto de requisição/resposta.

• Você está trabalhando com paradigmas de mensagens ou documentos FHIR em vez do modelo de interação da API RESTful.
• Você precisa de orientação sobre perfis FHIR, StructureDefinitions ou serviços de terminologia, que estão fora do escopo desta skill.

Cobre todas as interações REST principais do FHIR API: read, vread, create, update, patch, delete, search, history, capabilities e batch/transaction — com métodos HTTP corretos, padrões de URL e códigos de status de sucesso.

Explica os tipos MIME do FHIR (application/fhir+json, application/fhir+xml, application/fhir+turtle), o uso correto dos cabeçalhos Accept e Content-Type, a negociação de versão do FHIR e o parâmetro de fallback _format.

Orienta a implementação do rastreamento de versão baseado em ETag usando cabeçalhos If-Match e explica como lidar com respostas 412 Precondition Failed para atualizações concorrentes seguras.

Fornece estruturas de resposta OperationOutcome corretas e mapeia os códigos de status HTTP específicos do FHIR (400, 404, 409, 410, 412, 422) para seus casos de uso apropriados.

Explica como respeitar o cabeçalho Prefer para return=minimal, return=representation, return=OperationOutcome e padrões de operação assíncrona com 202 Accepted.

Inclui uma lista de verificação prática cobrindo CapabilityStatement em /metadata, suporte a ETag, cabeçalho Location em criação/atualização e fallback do parâmetro _format para ajudar a garantir a conformidade com a especificação.

Construa um servidor FHIR REST em conformidade com os padrões, incluindo manipuladores de rotas corretos, cabeçalhos de resposta e respostas de erro para tipos de recursos como Patient, Observation ou DiagnosticReport.

Desenvolva um cliente que construa corretamente requisições HTTP para FHIR API, negocie o formato de conteúdo, gerencie versões de recursos com ETags e analise erros de OperationOutcome.

Implemente lotes FHIR ou pacotes de transação enviados para a URL base, tratando tipos de operações mistas e semânticas de transações atômicas.

Valide estruturas de rotas e mapeamentos de operações planejadas da FHIR API em conformidade com a especificação HL7 antes de se comprometer com uma implementação.