Acessar os Serviços de Dados de Saúde do Azure usando a Extensão do Cliente REST no Visual Studio Code
Neste artigo, você aprenderá a acessar os Serviços de Dados de Saúde do Azure usando a extensão do Cliente REST no Visual Studio Code.
Instalar a extensão do Cliente REST
Selecione o ícone Extensões no painel esquerdo do Visual Studio Code e pesquise "Cliente REST". Localize a extensão de Cliente REST e instale-a.
Criar um arquivo .http e definir variáveis
Crie um novo arquivo no Visual Studio Code. Insira uma linha de comando de solicitação GET no arquivo e salve-a como test.http. O sufixo .http do arquivo ativa automaticamente o ambiente do Cliente REST. Selecione Send Request para obter os metadados.
Obter valores de aplicativo cliente
Importante
Antes de chamar a API REST do servidor FHIR® (além de obter os metadados), é necessário concluir o registro de aplicativo. Anote a ID do locatário, a ID do cliente, o segredo do cliente e a URL do serviço do Azure.
Embora você possa usar valores como a ID do cliente diretamente em chamadas para a API REST, é uma boa prática definir algumas variáveis para esses valores e usar as variáveis.
No arquivo test.http, inclua as seguintes informações obtidas ao registrar seu aplicativo.
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Obter um token de acesso do Microsoft Entra
Depois de incluir as seguintes informações em seu arquivo test.http, clique em Send Request. Você verá uma resposta HTTP que contém seu token de acesso.
A linha que começa com @name contém uma variável que captura a resposta HTTP que contém o token de acesso. A variável, @token, é usada para armazenar o token de acesso.
Observação
O grant_type de client_credentials é usado para obter um token de acesso.
### Get access token
# @name getAADToken
POST https://login.microsoftonline.com/{{tenantid}}/oauth2/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&resource={{fhirurl}}
&client_id={{clientid}}
&client_secret={{clientsecret}}
&scope={{fhirurl}}/.default
### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}
Observação
Quando o parâmetro de público-alvo do serviço FHIR não for mapeado para a URL do ponto de extremidade do serviço FHIR, o valor do parâmetro do recurso deverá ser mapeado para o valor de Público-Alvo na folha Autenticação do Serviço FHIR.
Obter dados do Paciente FHIR
Agora você pode obter uma lista de pacientes ou um paciente específico com a solicitação GET. A linha com Authorization são as informações de cabeçalho da solicitação GET. Você também pode enviar solicitações PUT ou POST para criar e atualizar recursos FHIR.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
Executar o PowerShell ou a CLI
Você pode executar scripts do PowerShell ou da CLI no Visual Studio Code. Pressione CTRL e a tecla ~ e selecione PowerShell ou Bash. Você pode encontrar mais detalhes sobre o Terminal Integrado.
PowerShell no Visual Studio Code
CLI no Visual Studio Code
Solução de problemas
Se não for possível obter os metadados (que não exigem token de acesso com base na especificação HL7), verifique se o servidor FHIR está sendo executado corretamente.
Se você não conseguir obter um token de acesso, verifique se o aplicativo cliente está registrado corretamente e se você está usando os valores corretos da etapa do registro de aplicativo.
Se você não conseguir obter dados do servidor FHIR, verifique se o aplicativo cliente (ou a entidade de serviço) recebeu permissões de acesso, como "Colaborador de Dados FHIR" para o servidor FHIR.
Próximas etapas
Neste artigo, você aprendeu a acessar dados dos Serviços de Dados de Saúde do Azure usando a extensão do Cliente REST no Visual Studio Code.
Para saber mais sobre como validar recursos FHIR em relação a perfis nos Serviços de Dados de Saúde do Azure, confira
Observação
FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.