Visual Studio Code'da REST İstemci Uzantısını kullanarak Azure Health Veri Hizmetlerine erişme
Bu makalede, Visual Studio Code'da REST İstemci uzantısını kullanarak Azure Health Veri Hizmetleri'ne erişmeyi öğreneceksiniz.
REST İstemci uzantısını yükleme
Visual Studio Code'unuzun sol tarafındaki panelde Uzantılar simgesini seçin ve "REST İstemcisi" araması yapın. REST İstemci uzantısını bulun ve yükleyin.
.http Dosya oluşturma ve değişkenleri tanımlama
Visual Studio Code'da yeni bir dosya oluşturun. Dosyaya bir GET istek komut satırı girin ve olarak test.httpkaydedin. Dosya son eki .http REST İstemcisi ortamını otomatik olarak etkinleştirir. Meta verileri almak için öğesini seçin Send Request .
İstemci uygulama değerlerini alma
Önemli
FHIR® sunucusu REST API'sini çağırmadan önce (meta verileri almak dışında) uygulama kaydını tamamlamanız gerekir. Azure kiracı kimliğinizi, istemci kimliğinizi, istemci gizli dizinizi ve hizmet URL'nizi not edin.
İstemci kimliği gibi değerleri doğrudan REST API çağrılarında kullanabilirsiniz ancak bu değerler için birkaç değişken tanımlamanız ve bunun yerine değişkenleri kullanmanız iyi bir uygulamadır.
Dosyanıza test.http , uygulamanızı kaydetmeden elde edilen aşağıdaki bilgileri ekleyin.
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Microsoft Entra erişim belirtecini alma
Aşağıdaki bilgileri dosyanıza test.http ekledikten sonra öğesine tıklayın Send Request. Erişim belirtecinizi içeren bir HTTP yanıtı görürsünüz.
ile @name başlayan satır, erişim belirtecini içeren HTTP yanıtını yakalayan bir değişken içerir. değişkeni, @tokenerişim belirtecini depolamak için kullanılır.
Not
grant_type, client_credentials erişim belirteci almak için kullanılır.
### 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}}
Not
FHIR hizmet hedef kitlesi parametresi FHIR hizmet uç noktası URL'si ile eşlenmediğinde, kaynak parametresi değeri FHIR Hizmet Kimlik Doğrulaması dikey penceresinin altındaki hedef kitle değerine eşlenmelidir.
FHIR Hasta verilerini alma
Artık istekte GET bulunan hastaların veya belirli bir hastanın listesini alabilirsiniz. ile Authorization satırı, isteğin üst bilgi bilgileridir GET . Ayrıca FHIR kaynaklarını oluşturmak ve güncelleştirmek için istek gönderebilir PUT veya POST istekte bulunabilirsiniz.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
PowerShell veya CLI çalıştırma
PowerShell veya CLI betiklerini Visual Studio Code içinde çalıştırabilirsiniz. Tuşuna ~ basın CTRL ve PowerShell veya Bash'i seçin. Tümleşik Terminal hakkında daha fazla ayrıntı bulabilirsiniz.
Visual Studio Code'da PowerShell
Visual Studio Code'da CLI
Sorun giderme
Meta verileri alamıyorsanız (HL7 belirtimine göre erişim belirteci gerektirmez) FHIR sunucunuzun düzgün çalışıp çalışmadığını denetleyin.
Erişim belirteci alamıyorsanız, istemci uygulamasının düzgün kaydedildiğinden ve uygulama kayıt adımındaki doğru değerleri kullandığınızdan emin olun.
FHIR sunucusundan veri alamıyorsanız, istemci uygulamaya (veya hizmet sorumlusuna) FHIR sunucusuna "FHIR Veri Katkıda Bulunanı" gibi erişim izinleri verildiğinden emin olun.
Sonraki adımlar
Bu makalede, Visual Studio Code'daki REST İstemci uzantısını kullanarak Azure Health Veri Hizmetleri verilerine erişmeyi öğrendiniz.
Azure Health Veri Hizmetleri'ndeki profillere göre FHIR kaynaklarını doğrulama hakkında bilgi edinmek için bkz.