Testar a API FHIR na API do Azure para FHIR

No tutorial anterior, implementou a API do Azure para FHIR e registou a aplicação cliente. Agora, está pronto para testar a sua API do Azure para FHIR.

Obter instrução de capacidade

Primeiro, obteremos a instrução de capacidade para a sua API do Azure para FHIR.

1. Abra o Postman.
2. Obtenha a instrução de capacidade ao efetuar GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. Na imagem abaixo, o nome do servidor FHIR é fhirserver.

Em seguida, tentaremos obter um paciente. Para obter um paciente, introduza GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Receberá um erro 401 Não autorizado. Este erro deve-se ao facto de ainda não ter provado que deve ter acesso aos dados dos pacientes.

Obter paciente a partir do servidor FHIR

Para obter acesso, precisa de um token de acesso.

1. Selecione Autorização e defina o Tipo como OAuth2.0 no Postman.
2. Selecione Obter Novo Token de Acesso.
3. Preencha os campos e selecione Pedir Token. Abaixo, pode ver os valores de cada campo para este tutorial.

Campo	Valor
Nome do Token	Um nome para o token
Tipo de Concessão	Código de Autorização
URL de chamada de retorno	https://www.getpostman.com/oauth2/callback
URL Auth	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	O ID de cliente que copiou durante os passos anteriores
Segredo do Cliente	<BLANK>
Âmbito	<BLANK>
Estado	1234
Autenticação de Cliente	Enviar credenciais de cliente no corpo

4. Inicie sessão com as suas credenciais e selecione Aceitar
5. Desloque-se para baixo no resultado e selecione Utilizar Token
6. Selecione Enviar novamente na parte superior e, desta vez, deverá obter um

Publicar paciente no servidor FHIR

Agora que tem acesso, pode criar um novo paciente. Eis uma amostra de um paciente simples que pode adicionar ao seu servidor FHIR. Introduza isto json na secçã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"
    }

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

Se executar o comando GET para obter um paciente novamente, verá James Tiberious Kirk listado na saída.

Nota

Ao enviar pedidos para a API do Azure para FHIR, tem de garantir que definiu o cabeçalho do tipo de conteúdo como application/json

Resolução de problemas de acesso

Se se deparou com problemas durante qualquer um destes passos, reveja os documentos que reunimos no Azure Active Directory e na API do Azure para FHIR.

• Azure AD e API do Azure para FHIR – este documento descreve alguns dos princípios básicos do Azure Active Directory e como interage com a API do Azure para FHIR.
• Validação de tokens de acesso – este guia de procedimentos fornece detalhes mais específicos sobre a validação do token de acesso e os passos a seguir para resolver problemas de acesso.

Passos Seguintes

Agora que pode ligar-se com êxito à sua aplicação cliente, está pronto para escrever a sua aplicação Web.

Escrever uma aplicação Web

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