Akses menggunakan Postman

Dalam artikel ini, kita akan menelusuri langkah-langkah mengakses Azure Health Data Services (dengar dengan layanan FHIR) dengan Postman.

Prasyarat

• Layanan FHIR disebarkan di Azure. Untuk informasi tentang cara menyebarkan layanan FHIR, lihat Menyebarkan layanan FHIR.
• Aplikasi klien terdaftar untuk mengakses layanan FHIR. Untuk informasi tentang cara mendaftarkan aplikasi klien, lihat Mendaftarkan aplikasi klien layanan di Azure Active Directory.
• Izin yang diberikan kepada aplikasi klien dan akun pengguna Anda, misalnya, "Kontributor Data FHIR", untuk mengakses layanan FHIR.
• Postman diinstal secara lokal. Untuk informasi selengkapnya tentang Postman, lihat Mulai menggunakan Postman.

Menggunakan Postman: membuat ruang kerja, koleksi, dan lingkungan

Jika Anda baru menggunakan Postman, ikuti langkah-langkah di bawah ini. Jika tidak, Anda dapat melewati langkah ini.

Postman memperkenalkan konsep ruang kerja untuk memungkinkan Anda dan tim Anda berbagi API, koleksi, lingkungan, dan komponen lainnya. Anda dapat menggunakan "Ruang kerja saya" atau "Ruang kerja tim" default atau membuat ruang kerja baru untuk Anda atau tim Anda.

Selanjutnya, buat koleksi baru tempat Anda dapat mengelompokkan semua permintaan REST API terkait. Di ruang kerja, pilih Buat Koleksi. Anda dapat menyimpan nama default Koleksi baru atau mengganti namanya. Perubahan disimpan secara otomatis.

Anda juga dapat mengimpor dan mengekspor koleksi Postman. Untuk informasi selengkapnya, lihat dokumentasi Postman.

Membuat atau memperbarui variabel lingkungan

Meskipun Anda dapat menggunakan URL lengkap dalam permintaan, disarankan agar Anda menyimpan URL dan data lain dalam variabel dan menggunakannya.

Untuk mengakses layanan FHIR, kita harus membuat atau memperbarui variabel berikut.

• tenantid – Penyewa Azure tempat layanan FHIR disebarkan. Ini terletak dari opsi menu Ringkasan pendaftaran aplikasi .
• subid – Langganan Azure tempat layanan FHIR disebarkan. Ini terletak dari opsi menu ringkasan layanan FHIR .
• clientid – ID pendaftaran klien aplikasi.
• clientsecret – Rahasia pendaftaran klien aplikasi.
• fhirurl – URL lengkap layanan FHIR. Contohnya:https://xxx.azurehealthcareapis.com Ini terletak dari opsi menu ringkasan layanan FHIR .
• bearerToken – Variabel untuk menyimpan token akses Azure Active Directory (Azure AD) dalam skrip. Biarkan kosong.

Catatan

Pastikan Anda telah mengonfigurasi URL pengalihan, https://www.getpostman.com/oauth2/callback, dalam pendaftaran aplikasi klien.

Menyambungkan ke server FHIR

Buka Postman, pilih ruang kerja, koleksi, dan lingkungan yang ingin Anda gunakan. + Pilih ikon untuk membuat permintaan baru.

Dapatkan pernyataan kemampuan

Masukkan {{fhirurl}}/metadata dalam GETpermintaan, dan pilih Send. Anda akan melihat pernyataan kemampuan layanan FHIR.

Mendapatkan token akses Azure Active Directory

Layanan FHIR diamankan oleh Azure AD. Autentikasi default tidak dapat dinonaktifkan. Untuk mengakses layanan FHIR, Anda harus mendapatkan token akses Azure Active Directory terlebih dahulu. Untuk informasi selengkapnya, lihat Token akses platform identitas Microsoft.

Buat permintaan baru POST :

1. Masukkan di header permintaan: https://login.microsoftonline.com/{{tenantid}}/oauth2/token

2. Pilih tab Isi dan pilih x-www-form-urlencoded. Masukkan nilai berikut di bagian kunci dan nilai:

   • grant_type: Client_Credentials
   • client_id: {{clientid}}
   • client_secret: {{clientsecret}}
   • sumber daya: {{fhirurl}}

3. Pilih tab Uji dan masukkan di bagian teks: pm.environment.set("bearerToken", pm.response.json().access_token); Untuk membuat nilai tersedia untuk koleksi, gunakan metode pm.collectionVariables.set. Untuk informasi selengkapnya tentang metode yang ditetapkan dan tingkat cakupannya, lihat Menggunakan variabel dalam skrip.

4. Pilih Simpan untuk menyimpan setelan.

5. Pilih Kirim. Anda akan melihat respons dengan token akses Azure Active Directory, yang disimpan ke variabel bearerToken secara otomatis. Anda kemudian dapat menggunakannya di semua permintaan API layanan FHIR.

Anda dapat memeriksa token akses menggunakan alat online seperti https://jwt.ms. Pilih tab Klaim untuk melihat deskripsi terperinci untuk setiap klaim dalam token.

Mendapatkan sumber daya FHIR

Setelah mendapatkan token akses Azure ACTIVE Directory, Anda dapat mengakses data FHIR. Dalam permintaan baru GET , masukkan {{fhirurl}}/Patient.

Pilih Token Pembawa sebagai jenis otorisasi. Masukkan {{bearerToken}} di bagian Token . Pilih Kirim. Sebagai respons, Anda akan melihat daftar pasien di sumber daya FHIR Anda.

Membuat atau memperbarui sumber daya FHIR Anda

Setelah mendapatkan token akses Azure Active Directory, Anda dapat membuat atau memperbarui data FHIR. Misalnya, Anda dapat membuat pasien baru atau memperbarui pasien yang ada.

Buat permintaan baru, ubah metode menjadi "Posting", dan masukkan nilai di bagian permintaan.

{{fhirurl}}/Patient

Pilih Token Pembawa sebagai jenis otorisasi. Masukkan {{bearerToken}} di bagian Token . Pilih tab Isi . Pilih opsi mentah dan JSON sebagai format teks isi. Salin dan tempel teks ke bagian isi.

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

Pilih Kirim. Anda akan melihat pasien baru dalam respons JSON.

Mengekspor data FHIR

Setelah mendapatkan token akses Azure ACTIVE Directory, Anda dapat mengekspor data FHIR ke akun penyimpanan Azure.

Buat permintaan baru GET : {{fhirurl}}/$export?_container=export

Pilih Token Pembawa sebagai jenis otorisasi. Masukkan {{bearerToken}} di bagian Token . Pilih Header untuk menambahkan dua header baru:

• Terima: application/fhir+json
• Lebih suka: respond-async

Pilih Kirim. Anda harus melihat 202 Accepted respons. Pilih tab Header respons dan catat nilai di Lokasi Konten. Anda bisa menggunakan nilai untuk mengkueri status pekerjaan ekspor.

Langkah berikutnya

Dalam artikel ini, Anda mempelajari cara mengakses layanan FHIR di Azure Health Data Services dengan Postman. Untuk informasi tentang layanan FHIR di Azure Health Data Services, lihat

Apa itu layanan FHIR?

FHIR® adalah merek dagang terdaftar HL7 dan digunakan dengan izin HL7.