Mengakses Azure Health Data Services menggunakan Ekstensi Klien REST di Visual Studio Code
Dalam artikel ini, Anda mempelajari cara mengakses Azure Health Data Services menggunakan ekstensi Klien REST di Visual Studio Code.
Menginstal ekstensi Klien REST
Pilih ikon Ekstensi di panel sisi kiri Visual Studio Code Anda, dan cari "Rest Client". Temukan ekstensi Klien REST dan instal.
Membuat .http file dan menentukan variabel
Buat file baru di Visual Studio Code. GET Masukkan baris perintah permintaan dalam file, dan simpan sebagai test.http. Akhiran .http file secara otomatis mengaktifkan lingkungan Klien REST. Pilih Send Request untuk mendapatkan metadata.
Mendapatkan nilai aplikasi klien
Penting
Sebelum memanggil REST API server FHIR® (selain mendapatkan metadata), Anda harus menyelesaikan pendaftaran aplikasi. Catat ID penyewa Azure, ID klien, rahasia klien, dan URL layanan Anda.
Meskipun Anda dapat menggunakan nilai seperti ID klien langsung dalam panggilan ke REST API, ini adalah praktik yang baik bahwa Anda menentukan beberapa variabel untuk nilai-nilai ini dan menggunakan variabel sebagai gantinya.
Dalam file Anda test.http , sertakan informasi berikut yang diperoleh dari mendaftarkan aplikasi Anda.
### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....
Mendapatkan token akses Microsoft Entra
Setelah menyertakan informasi berikut dalam file Anda test.http , tekan Send Request. Anda akan melihat respons HTTP yang berisi token akses Anda.
Baris yang dimulai dengan @name berisi variabel yang mengambil respons HTTP yang berisi token akses. Variabel, @token, digunakan untuk menyimpan token akses.
Catatan
dari grant_type client_credentials digunakan untuk mendapatkan token akses.
### 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}}
Catatan
Ketika parameter audiens layanan FHIR tidak dipetakan ke url titik akhir layanan FHIR, nilai parameter sumber daya harus dipetakan ke nilai Audiens di bawah bilah Autentikasi Layanan FHIR.
Mendapatkan data Pasien FHIR
Anda sekarang bisa mendapatkan daftar pasien atau pasien tertentu dengan permintaan tersebut GET . Baris dengan Authorization adalah info header untuk GET permintaan. Anda juga dapat mengirim PUT atau POST meminta untuk membuat dan memperbarui sumber daya FHIR.
### GET Patient
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}
Menjalankan PowerShell atau CLI
Anda dapat menjalankan skrip PowerShell atau CLI dalam Visual Studio Code. Tekan CTRL dan tombol ~ dan pilih PowerShell atau Bash. Anda dapat menemukan detail selengkapnya di Terminal Terintegrasi.
PowerShell di Visual Studio Code
CLI di Visual Studio Code
Pemecahan Masalah
Jika Anda tidak dapat mendapatkan metadata (yang tidak memerlukan token akses berdasarkan spesifikasi HL7) periksa apakah server FHIR Anda berjalan dengan benar.
Jika Anda tidak bisa mendapatkan token akses, pastikan aplikasi klien terdaftar dengan benar dan Anda menggunakan nilai yang benar dari langkah pendaftaran aplikasi.
Jika Anda tidak dapat mendapatkan data dari server FHIR, pastikan bahwa aplikasi klien (atau perwakilan layanan) telah diberikan izin akses seperti "Kontributor Data FHIR" ke server FHIR.
Langkah berikutnya
Dalam artikel ini, Anda mempelajari cara mengakses data Azure Health Data Services menggunakan ekstensi Klien REST di Visual Studio Code.
Untuk mempelajari tentang cara memvalidasi sumber daya FHIR terhadap profil di Azure Health Data Services, lihat