Acesso usando Carteiro

Neste artigo, vamos percorrer os passos de acesso aos Serviços de Dados de Saúde do Azure (doravante chamado serviço FHIR) com o Carteiro.

Pré-requisitos

Utilização do Carteiro: criar espaço de trabalho, coleção e ambiente

Se é novo no Carteiro, siga os passos abaixo. Caso contrário, podes saltar este passo.

O Carteiro introduz o conceito de espaço de trabalho para permitir que você e a sua equipa partilhem APIs, coleções, ambientes e outros componentes. Pode utilizar o padrão "O meu espaço de trabalho" ou "espaço de trabalho em equipa" ou criar um novo espaço de trabalho para si ou para a sua equipa.

Screenshot de criar um novo espaço de trabalho no Carteiro.

Em seguida, crie uma nova coleção onde pode agrupar todos os pedidos relacionados com a API rest. No espaço de trabalho, selecione Criar Coleções. Pode manter o nome predefinido Nova coleção ou renomeá-lo. A alteração é guardada automaticamente.

Screenshot de criar uma nova coleção.

Também pode importar e exportar coleções de carteiros. Para mais informações, consulte a documentação do Carteiro.

Screenshot de dados de importação.

Criar ou atualizar variáveis ambientais

Embora possa utilizar o URL completo no pedido, recomenda-se que guarde o URL e outros dados em variáveis e os utilize.

Para aceder ao serviço FHIR, precisamos de criar ou atualizar as seguintes variáveis.

  • inquilino – Inquilino Azure onde o serviço FHIR é implantado. Está localizado a partir da opção do menu de registo de inscrição da Aplicação .
  • Subíndes – Assinatura Azure onde o serviço FHIR é implantado. Está localizado a partir da opção de menu geral do serviço FHIR .
  • clientid – Identificação de registo de cliente de aplicação.
  • segredo de registo de clientes de aplicação .
  • fhirurl – O serviço FHIR FULL URL. Por exemplo, https://xxx.azurehealthcareapis.com. Está localizado a partir da opção de menu geral do serviço FHIR .
  • bearerToken – A variável para armazenar o Azure Ative Directory (Azure AD) token de acesso no script. Deixe em branco.

Nota

Certifique-se de que configura o URL de redirecionamento, https://www.getpostman.com/oauth2/callbackno registo de inscrição do cliente.

Screenshot da variável ambientes.

Ligue-se ao servidor FHIR

Open Postman, selecione o espaço de trabalho, a recolha e o ambiente que pretende utilizar. Selecione o + ícone para criar um novo pedido.

Screenshot de criar um novo pedido.

Obter declaração de capacidade

Insira {{fhirurl}}/metadata o GETpedido e selecione Send. Deve ver a declaração de capacidade do serviço FHIR.

Screenshot dos parâmetros de declaração de capacidade.

Screenshot do pedido de salvamento.

Obter Azure AD símbolo de acesso

O serviço FHIR é assegurado por Azure AD. A autenticação predefinida não pode ser desativada. Para aceder ao serviço FHIR, você deve obter um Azure AD o token de acesso primeiro. Para mais informações, consulte plataforma de identidades da Microsoft fichas de acesso.

Criar um novo POST pedido:

  1. Insira o cabeçalho do pedido: https://login.microsoftonline.com/{{tenantid}}/oauth2/token

  2. Selecione o separador Corpo e selecione x-www-form-urlencoded. Introduza os seguintes valores na secção chave e valor:

    • grant_type: Client_Credentials
    • client_id: {{clientid}}
    • client_secret: {{clientsecret}}
    • recurso: {{fhirurl}}
  3. Selecione o separador Teste e introduza na secção de texto: pm.environment.set("bearerToken", pm.response.json().access_token); Para disponibilizar o valor à coleção, utilize o método pm.collectionVariables.set. Para obter mais informações sobre o método definido e o seu nível de âmbito, consulte utilizando variáveis em scripts.

  4. Selecione Guardar para guardar as definições.

  5. Selecione Enviar. Deve ver uma resposta com o token de acesso Azure AD, que é guardado automaticamente para a variávelbearerToken. Em seguida, pode usá-lo em todos os pedidos de serviço da FHIR API.

Screenshot do botão de envio.

Pode examinar o token de acesso usando ferramentas online tais como https://jwt.ms. Selecione o separador Reclamações para ver descrições detalhadas para cada reclamação no token.

Screenshot de acesso a pedidos de token.

Obtenha recurso FHIR

Depois de obter um Azure AD ficha de acesso, pode aceder aos dados do FHIR. Num novo GET pedido, insira {{fhirurl}}/Patient.

Selecione o Token do Portador como tipo de autorização. Insira {{bearerToken}} na secção Token . Selecione Enviar. Como resposta, deve ver uma lista de pacientes no seu recurso FHIR.

Screenshot do símbolo do portador selecionado.

Criar ou atualizar o seu recurso FHIR

Depois de obter um token de acesso Azure AD, pode criar ou atualizar os dados do FHIR. Por exemplo, pode criar um novo paciente ou atualizar um paciente existente.

Crie um novo pedido, altere o método para "Post", e introduza o valor na secção de pedido.

{{fhirurl}}/Patient

Selecione o Bearer Token como o tipo de autorização. Insira {{bearerToken}} na secção Token . Selecione o separador Corpo . Selecione a opção bruta e o JSON como formato de texto corporal. Copiar e colar o texto para a secção do corpo.

{
    "resourceType": "Patient",
    "active": true,
    "name": [
        {
            "use": "official",
            "family": "Kirk",
            "given": [
                "James",
                "Tiberious"
            ]
        },
        {
            "use": "usual",
            "given": [
                "Jim"
            ]
        }
    ],
    "gender": "male",
    "birthDate": "1960-12-25"
}

Selecione Enviar. Devias ver um novo paciente na resposta do JSON.

Screenshot do botão de envio para criar um novo paciente.

Exportar dados do FHIR

Depois de obter um token de acesso Azure AD, pode exportar dados de FHIR para uma conta de armazenamento Azure.

Criar um novo GET pedido: {{fhirurl}}/$export?_container=export

Selecione o Token do Portador como tipo de autorização. Insira {{bearerToken}} na secção Token . Selecione Cabeçalhos para adicionar dois novos cabeçalhos:

  • Aceitar: application/fhir+json
  • Prefere: respond-async

Selecione Enviar. Devia notar uma 202 Accepted resposta. Selecione o separador Cabeçalhos da resposta e tome nota do valor na Localização do Conteúdo. Pode utilizar o valor para consultar o estado do trabalho de exportação.

Screenshot do post para criar uma nova resposta aceite pelo paciente 202.

Passos seguintes

Neste artigo, aprendeu a aceder ao serviço FHIR em Azure Health Data Services com Carteiro. Para obter informações sobre o serviço FHIR nos Serviços de Dados de Saúde Azure, consulte

FHIR® é uma marca registada do HL7 e é usada com a permissão do HL7.