Acessando as APIs de saúde (versão prévia) usando a extensão de cliente REST no Visual Studio Code

Importante

As APIs de saúde do Azure estão atualmente em versão prévia. Os Termos de Uso Complementares para Versões Prévias do Microsoft Azure incluem termos legais adicionais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

Neste artigo, você aprenderá a acessar as APIs de saúde usando a extensão de cliente REST no Visual Studio Code.

Instalar extensão de cliente REST

selecione o ícone extensões no painel do lado esquerdo de seu Visual Studio Code e pesquise "cliente REST". Localize a extensão de cliente REST e instale.

Extensão VSCode do cliente REST

Criar um .http arquivo e definir variáveis

Crie um novo arquivo no Visual Studio Code. Insira uma GET linha de comando de solicitação no arquivo e salve-a como test.http . O sufixo do arquivo .http ativa automaticamente o ambiente do cliente REST. Clique em ativar Send Request para obter os metadados.

Enviar solicitação

Obter valores do aplicativo cliente

Importante

Antes de chamar a API REST do servidor FHIR (diferente de obter os metadados), você deve concluir o registro do aplicativo. Anote a ID do locatário do Azure, a ID do cliente, o segredo do cliente e a URL do serviço.

Embora você possa usar valores como a ID do cliente diretamente em chamadas para a API REST, é uma boa prática que você defina algumas variáveis para esses valores e use as variáveis em vez disso.

Em seu test.http arquivo, inclua as seguintes informações obtidas do registro do seu aplicativo:

### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....

Obter token de acesso do AD do Azure

Depois de incluir as informações abaixo no test.http arquivo, clique em Send Request . Você verá uma resposta HTTP que contém o 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}}

### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}

Obter token de acesso

GET FHIR dados de pacientes

Agora você pode obter uma lista de pacientes ou um paciente específico com a GET solicitação. A linha com Authorization é a informação de cabeçalho para a GET solicitação. Você também pode enviar PUT ou POST solicitar para criar/atualizar recursos do FHIR.

### GET Patient 
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}

Obter paciente

Executar o PowerShell ou a CLI

Você pode executar scripts do PowerShell ou da CLI dentro do 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

executando o PowerShell

CLI no Visual Studio Code

executando a CLI

Solução de problemas

Se não for possível obter os metadados, que não exigem o token de acesso com base na especificação HL7, verifique se o servidor FHIR está sendo executado corretamente.

Se não for possível obter um token de acesso, verifique se o aplicativo cliente está registrado corretamente e se você está usando os valores corretos da etapa de registro do aplicativo.

Se não for possível 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 do FHIR", para o servidor FHIR.