Testando a API FHIR na API do Azure para FHIR

Artigo
12/04/2024

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 o serviço 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 FHIR dos Serviços de Dados de Saúde do Azure é a versão evoluída da API do Azure para FHIR que permite aos clientes gerir serviços FHIR, DICOM e MedTech com integrações noutros 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 declaração de capacidade para sua API do Azure para FHIR.

Carteiro aberto.
Recupere a instrução de capacidade usando GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. Na imagem abaixo o nome do servidor FHIR é fhirserver.

Declaração de capacidade

Em seguida, tentamos recuperar um paciente. Para recuperar um paciente, use GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Você recebe um 401 Unauthorized erro porque não provou que deveria ter acesso aos dados do paciente.

Doente Falhado

Obter paciente do servidor 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 para cada campo para este tutorial.

Campo	Value
Nome do token	Um nome para o seu token
Tipo de subvençã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 de Cliente	A ID do cliente que você copiou durante as etapas anteriores
Segredo do Cliente	<EM BRANCO>
Âmbito	<EM BRANCO>
Estado	1234
Autenticação de Cliente	Enviar credenciais de cliente no corpo

Inicie sessão com as suas credenciais e selecione Aceitar
Role para baixo no resultado e selecione Usar token
Selecione Enviar novamente na parte superior e desta vez você deve obter um resultado:

Paciente de Sucesso

Postar o paciente no servidor FHIR

Agora que você tem acesso, você pode criar um novo paciente. Aqui está uma amostra de um paciente simples que você pode adicionar ao seu servidor FHIR. Insira isso json na seção Corpo do Carteiro.

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

Este POST cria um novo paciente no seu servidor FHIR com o nome James Tiberious Kirk.

Pós-Doente

Se você usar o comando GET para recuperar um paciente novamente, verá James Tiberious Kirk listado na saída.

Nota

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

Resolução de problemas de acesso

Receber um erro 403 ao tentar acessar o recurso Paciente do Postman.

Verifique se a função de Colaborador FHIR está atribuída; se não estiver, adicione a função de Colaborador FHIR aos Serviços de Dados de Saúde do Azure. Configurar funções do Azure RBAC para AHDS

Se você tiver problemas durante qualquer uma dessas etapas, revise os documentos que reunimos na ID do Microsoft Entra e na API do Azure para FHIR.

Microsoft Entra ID e Azure API for 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 de token de acesso - Este guia de instruções fornece detalhes mais específicos sobre a validação de token de acesso e as etapas a serem tomadas para resolver problemas de acesso.

Passos Seguintes

Agora que você pode se conectar com êxito ao seu aplicativo cliente, você está pronto para escrever seu aplicativo Web.

Escrever uma aplicação Web

Nota

FHIR® é uma marca registada da HL7 e é utilizada com a permissão da HL7.

Partilhar via