GNU Health/Usando o Servidor FHIR REST

Visão Geral do FHIR

editar

Recursos de Interoperabilidade de Cuidados Rápidos (Fast Healthcare Interoperability Resources -FHIR) é um padrão para troca de informações de saúde desenvolvido eletronicamente por HL7. É uma norma que define uma interface comum para a interoperabilidade de software médico. Para mais informações acesse Padronização FHIR.

Estrutura da URL

editar

O padrão FHIR define uma API REST, um conjunto de interações com cada recurso. Cada recurso lida com diferentes tipos de informação. Atualmente, o servidor FHIR GNU Health suporta 12 recursos:

  • Conformidade: descreve as capacidades FHIR do servidor.
  • Paciente: as informações do paciente, como e-mail, endereço, número de identidade, etc.
  • Relatório de Diagnóstico: os testes de laboratório que foram feitos, mas não os dados
  • Observação: os dados laboratório, como valores de ácido úrico
  • Profissionais: os profissionais de saúde e suas informações
  • Procedimento: as cirurgias/operações
  • Estado: doenças/diagnósticos
  • Histórico Familiar: histórias familiares de pacientes
  • Medicação: remédios (não prescrições!)
  • Declaração de Medicação: medicamentos tomados por um paciente
  • Imunização: Imunizações
  • Organização: Instituições, departamentos, empresas, etc.

Cada recurso tem sua finalidade. Por exemplo, a finalidade ligadas ao Paciente' é encontrada em /Paciente, a finalidade ligada ao Relatório de Diagnóstico está em /DiagnosticReport, e assim por diante. A única exceção a este esquema de nomeação é a finalidade Conformidade que se encontra em / e /metadata.

As interações usam chamadas de HTTP. Interações de leitura e pesquisas simples são chamadas com GET, e assim por diante.

Para mais informações e ficar por dentro da arquitetura REST, acesse a documentação.

Nota: Atualmente, o servidor FHIR GNU Health não tem nenhuma funcionalidade de gravação.

Autenticação

editar

Todos os recursos, exceto para Conformidade, exigem autenticação. O servidor autentica com as credenciais do usuário do servidor GNU Health/Tryton subjacente. Entre com suas credenciais de usuário em /auth/login. Saia em /auth/logout. Há uma página de boas-vindas simples para os usuários logados em /auth/home.

Procurando/Listando

editar

Para procurar um recurso, basta adicionar argumentos na finalidade para refinar a pesquisa. Por exemplo, /Paciente, irá retornar todos os pacientes no servidor. /Paciente?Name=ana irá retornar todos os pacientes que possuem Ana em seu nome.

Nota:. Muitos critérios de pesquisa para o servidor FHIR GNU Health ainda não são suportados. Consulte a documentação FHIR para mais informações.

Exemplos de Servidor de Teste

editar

Alguns exemplos com o servidor da comunidade FHIR (pode precisar de autenticação):