Uzyskiwanie dostępu do usług Azure Health Data Services przy użyciu rozszerzenia klienta REST w programie Visual Studio Code
Z tego artykułu dowiesz się, jak uzyskać dostęp do usług Azure Health Data Services przy użyciu rozszerzenia klienta REST w programie Visual Studio Code.
Instalowanie rozszerzenia klienta REST
Wybierz ikonę Rozszerzenia w panelu po lewej stronie programu Visual Studio Code i wyszukaj frazę "Klient REST". Znajdź rozszerzenie klienta REST i zainstaluj go.
Tworzenie .http pliku i definiowanie zmiennych
Utwórz nowy plik w programie Visual Studio Code. GET Wprowadź wiersz polecenia żądania w pliku i zapisz go jako test.http. Sufiks .http pliku automatycznie aktywuje środowisko klienta REST. Wybierz Send Request , aby pobrać metadane.
Pobieranie wartości aplikacji klienckiej
Ważne
Przed wywołaniem interfejsu API REST serwera FHIR® (innym niż pobieranie metadanych) należy ukończyć rejestrację aplikacji. Zanotuj identyfikator dzierżawy platformy Azure, identyfikator klienta, wpis tajny klienta i adres URL usługi.
Chociaż można użyć wartości, takich jak identyfikator klienta bezpośrednio w wywołaniach interfejsu API REST, dobrym rozwiązaniem jest zdefiniowanie kilku zmiennych dla tych wartości i użycie zmiennych.
W pliku test.http dołącz następujące informacje uzyskane z rejestrowania aplikacji.
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Uzyskiwanie tokenu dostępu firmy Microsoft Entra
Po uwzględnieniu poniższych informacji w test.http pliku naciśnij pozycję Send Request. Zobaczysz odpowiedź HTTP zawierającą token dostępu.
Wiersz rozpoczynający się od @name zawiera zmienną, która przechwytuje odpowiedź HTTP zawierającą token dostępu. Zmienna , @tokensłuży do przechowywania tokenu dostępu.
Uwaga
Element grant_type z client_credentials służy do uzyskiwania tokenu dostępu.
### 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}}
&scope={{fhirurl}}/.default
### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}
Uwaga
Jeśli parametr odbiorców usługi FHIR nie jest mapowany na adres URL punktu końcowego usługi FHIR, wartość parametru zasobu powinna zostać zamapowana na wartość Odbiorcy w bloku Uwierzytelnianie usługi FHIR.
Pobieranie danych pacjentów FHIR
Teraz możesz uzyskać listę pacjentów lub konkretnego pacjenta z żądaniem GET . Wiersz z Authorization to informacje nagłówkowe GET dla żądania. Możesz również wysyłać PUT żądania lub POST tworzyć i aktualizować zasoby FHIR.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
Uruchamianie programu PowerShell lub interfejsu wiersza polecenia
Skrypty programu PowerShell lub interfejsu wiersza polecenia można uruchamiać w programie Visual Studio Code. Naciśnij CTRL i ~ wybierz pozycję PowerShell lub Bash. Więcej szczegółów można znaleźć w zintegrowanym terminalu.
Program PowerShell w programie Visual Studio Code
Interfejs wiersza polecenia w programie Visual Studio Code
Rozwiązywanie problemów
Jeśli nie możesz pobrać metadanych (które nie wymagają tokenu dostępu na podstawie specyfikacji HL7), sprawdź, czy serwer FHIR działa prawidłowo.
Jeśli nie możesz uzyskać tokenu dostępu, upewnij się, że aplikacja kliencka jest poprawnie zarejestrowana i używasz poprawnych wartości z kroku rejestracji aplikacji.
Jeśli nie możesz pobrać danych z serwera FHIR, upewnij się, że aplikacja kliencka (lub jednostka usługi) ma przyznane uprawnienia dostępu, takie jak "Współautor danych FHIR" do serwera FHIR.
Następne kroki
W tym artykule przedstawiono sposób uzyskiwania dostępu do danych usług Azure Health Data Services przy użyciu rozszerzenia klienta REST w programie Visual Studio Code.
Aby dowiedzieć się, jak weryfikować zasoby FHIR względem profilów w usługach Azure Health Data Services, zobacz
Uwaga
FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7.