Testando a API FHIR na API do Azure para FHIR
Importante
A API do Azure para FHIR será desativada em 30 de setembro de 2026. Siga as estratégias de migração para fazer a transição para FHIR® dos Serviços de Dados de Saúde do Azure até essa data. Devido à desativação da API do Azure para FHIR, novas implantações não serão permitidas a partir de 1º de abril de 2025. O serviço dos Serviços de Dados de Saúde do Azure para serviço FHIR é a versão evoluída da API do Azure para FHIR que permite aos clientes gerenciar os serviços FHIR, DICOM e serviço de tecnologia médica com integrações a outros serviços do Azure.
No tutorial anterior, você implantou a API do Azure para FHIR® e registrou seu aplicativo cliente. Agora você está pronto para testar sua API do Azure para FHIR.
Recuperar a instrução de capacidade
Primeiro, obtemos a instrução de capacidade da sua API do Azure para FHIR.
- Abra o Postman.
- Recupere a instrução de capacidade usando
GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. Na imagem abaixo, o nome do servidor FHIR é fhirserver.
Em seguida, tentamos recuperar os dados de um paciente. Para recuperar os dados de um paciente, use GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Você recebe um erro 401 Unauthorized porque você não comprovou que deve ter acesso aos dados do paciente.
Obter paciente do servidor do FHIR
Para obter acesso, você precisa de um token de acesso.
- Selecione Autorização e defina o Tipo como OAuth2.0 no Postman.
- Selecione Obter Novo Token de Acesso.
- Preencha os campos e selecione Token de Solicitação. Abaixo, você pode ver os valores de cada campo deste tutorial.
| Campo | Valor |
|---|---|
| Nome do Token | Um nome para o token |
| Tipo de concessão | Código de autorização |
| URL de retorno de chamada | https://www.getpostman.com/oauth2/callback |
| URL de autenticação | https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME>.azurehealthcareapis.com |
| URL do token de acesso | https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token |
| ID do Cliente | A ID do cliente que você copiou nas etapas anteriores |
| Segredo do Cliente | <EM BRANCO> |
| Escopo | <EM BRANCO> |
| Estado | 1234 |
| Autenticação de cliente | Enviar credenciais do cliente no corpo |
- Entre com suas credenciais e selecione Aceitar
- Role para baixo no resultado e selecione Usar Token
- Selecione Enviar novamente na parte superior e, desta vez, você deverá obter um resultado:
Poste o paciente no servidor do FHIR
Agora que tem acesso, você pode criar um novo paciente. Aqui está uma amostra de simples de um paciente que você pode adicionar ao seu servidor do FHIR. Insira este json na seção Corpo do Postman.
{
"resourceType": "Patient",
"active": true,
"name": [
{
"use": "official",
"family": "Kirk",
"given": [
"James",
"Tiberious"
]
},
{
"use": "usual",
"given": [
"Jim"
]
}
],
"gender": "male",
"birthDate": "1960-12-25"
}
Essa ação POST cria um novo paciente em seu servidor FHIR com o nome James Tiberious Kirk.
Se você usar o comando GET para recuperar dados de um paciente novamente, verá James Tiberious Kirk listado na saída.
Observação
Ao enviar solicitações para a API do Azure para FHIR, você precisa garantir que definiu o cabeçalho do tipo de conteúdo como application/json
Solução de problemas de acesso
Recebimento de um erro 403 ao tentar acessar o recurso Paciente do Postman.
Verifique se a função Colaborador do FHIR está atribuída; se não estiver, adicione a função Colaborador do FHIR aos Serviços de Dados de Saúde do Azure. Configurar funções RBAC do Azure para AHDS
Se você tiver problemas durante qualquer uma dessas etapas, consulte os documentos que reunimos sobre o Microsoft Entra ID Azure e a API do Azure para FHIR.
- Microsoft Entra ID e API do Azure para FHIR - Este documento descreve alguns dos princípios básicos do Microsoft Entra ID e como ele interage com a API do Azure para FHIR.
- Validação do token de acesso – esse guia de instruções passo a passo apresenta detalhes mais específicos sobre a validação de token de acesso e as etapas a serem executadas para resolver problemas de acesso.
Próximas etapas
Agora que você pode se conectar com sucesso ao seu aplicativo cliente, está pronto para escrever seu aplicativo Web.
Observação
FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.