Testowanie interfejsu API FHIR w interfejsie API platformy Azure dla platformy FHIR

W poprzednim samouczku wdrożono interfejs API platformy Azure dla platformy FHIR i zarejestrowano aplikację klienczą. Teraz możesz przystąpić do testowania interfejsu API platformy Azure dla platformy FHIR.

Pobieranie instrukcji capability

Najpierw uzyskamy instrukcję capability dla interfejsu API platformy Azure for FHIR.

1. Otwórz narzędzie Postman.
2. Pobierz instrukcję capability, wykonując czynności GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. Na poniższej ilustracji nazwa serwera FHIR jest fhirserver.

Następnie spróbujemy pobrać pacjenta. Aby pobrać pacjenta, wprowadź wartość GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Zostanie wyświetlony błąd 401 Brak autoryzacji. Ten błąd jest spowodowany tym, że nie sprawdzono, że należy mieć dostęp do danych pacjentów.

Pobieranie pacjenta z serwera FHIR

Aby uzyskać dostęp, potrzebujesz tokenu dostępu.

1. Wybierz pozycję Autoryzacja i ustaw typ na OAuth2.0 w narzędziu Postman.
2. Wybierz pozycję Get New Access Token (Uzyskaj nowy token dostępu).
3. Wypełnij pola i wybierz pozycję Żądaj tokenu. Poniżej przedstawiono wartości dla każdego pola dla tego samouczka.

Pole	Wartość
Nazwa tokenu	Nazwa tokenu
Typ udzielenia	Kod autoryzacji
Adres URL wywołania zwrotnego	https://www.getpostman.com/oauth2/callback
Adres URL uwierzytelniania	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME.azurehealthcareapis.com>
Adres URL tokenu dostępu	https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token
Identyfikator klienta	Identyfikator klienta skopiowany podczas poprzednich kroków
Klucz tajny klienta	<BLANK>
Zakres	<BLANK>
Stan	1234
Uwierzytelnianie klienta	Wysyłanie poświadczeń klienta w treści

4. Zaloguj się przy użyciu poświadczeń i wybierz pozycję Akceptuj
5. Przewiń w dół wynik i wybierz pozycję Użyj tokenu
6. Wybierz pozycję Wyślij ponownie u góry, a tym razem powinien zostać wyświetlony wynik

Publikowanie pacjenta na serwerze FHIR

Teraz masz dostęp, możesz utworzyć nowego pacjenta. Oto przykład prostego pacjenta, który można dodać do serwera FHIR. Wprowadź tę json wartość w sekcji Treść narzędzia Postman.

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

Ten POST utworzy nowego pacjenta na serwerze FHIR o nazwie James Tiberious Kirk.

Jeśli wykonasz polecenie GET, aby ponownie pobrać pacjenta, zobaczysz James Tiberious Kirk wymieniony w danych wyjściowych.

Uwaga

Podczas wysyłania żądań do interfejsu API platformy Azure for FHIR należy upewnić się, że ustawiono nagłówek typu zawartości na application/json

Rozwiązywanie problemów z dostępem

Jeśli napotkasz problemy podczas dowolnego z tych kroków, zapoznaj się z dokumentami, które zebraliśmy w usłudze Azure Active Directory i interfejsie API platformy Azure dla platformy FHIR.

• Azure AD i interfejs API platformy Azure for FHIR — w tym dokumencie opisano niektóre podstawowe zasady usługi Azure Active Directory i sposób interakcji z interfejsem API platformy Azure for FHIR.
• Weryfikacja tokenu dostępu — ten przewodnik z instrukcjami zawiera bardziej szczegółowe informacje na temat weryfikacji tokenu dostępu i kroków, które należy wykonać w celu rozwiązania problemów z dostępem.

Następne kroki

Teraz, gdy możesz pomyślnie nawiązać połączenie z aplikacją klienczą, możesz przystąpić do pisania aplikacji internetowej.

Pisanie aplikacji internetowej

FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7 .