GNU Health/Usando o Servidor FHIR REST
Visão Geral do FHIR
[editar | editar código-fonte]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 | editar código-fonte]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 | editar código-fonte]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 | editar código-fonte]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 | editar código-fonte]Alguns exemplos com o servidor da comunidade FHIR (pode precisar de autenticação):
- Lista todos os pacientes
- Mostra informações de identificação do paciente número 1
- Liste todos os pacientes que possuem ana em seu nome
- Lista todas as cirurgias
- Lista página 2 de dados do laboratório com 3 por página
- Lista de dados do laboratório para as pessoas com betz no último nome
- Lista de laboratório para o paciente número 1
- Listar todos os CBCs de paciente número 1