GNU Health/Usando o Servidor FHIR REST
Visão Geral do FHIR
editarRecursos 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
editarO 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
editarTodos 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
editarPara 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
editarAlguns 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