Aracılığıyla paylaş


FHIR için Azure API'de FHIR API'sini test etme

Önemli

FHIR İçin Azure API'si 30 Eylül 2026 tarihinde kullanımdan kaldırılacaktır. Bu tarihe kadar Azure Health Data Services FHIR® hizmetine geçiş yapmak için geçiş stratejilerini izleyin. FHIR İçin Azure API'sinin kullanımdan kaldırılması nedeniyle 1 Nisan 2025 tarihinden itibaren yeni dağıtımlara izin verilmeyecektir. Azure Health Data Services FHIR hizmeti , müşterilerin FHIR, DICOM ve MedTech hizmetlerini diğer Azure hizmetleriyle tümleştirmelerle yönetmesine olanak tanıyan FHIR için Azure API'sinin gelişmiş sürümüdür.

Önceki öğreticide FHIR için Azure API'sini dağıttınız ve istemci uygulamanızı kaydettiniz. Artık FHIR için Azure API'nizi test etmeye hazırsınız.

Capability deyimini alma

İlk olarak FHIR için Azure API'nizin yetenek deyimini alacağız.

  1. Postman'i açın.
  2. yaparak GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadatayetenek deyimini alın. Aşağıdaki resimde FHIR sunucu adı fhirserver'dır.

Capability Deyimi

Şimdi bir hastayı almaya çalışacağız. Bir hastayı almak için girin GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. 401 Yetkisiz hatası alırsınız. Bu hatanın nedeni hasta verilerine erişiminiz olması gerektiğini kanıtlamamış olmanızdır.

FHIR sunucusundan hasta alma

Başarısız Hasta

Erişim kazanmak için bir erişim belirtecine ihtiyacınız vardır.

  1. Yetkilendirme'yi seçin ve Postman'de Tür değerini OAuth2.0 olarak ayarlayın.
  2. Yeni Erişim Belirteci Al'ı seçin.
  3. Alanları doldurun ve İstek Belirteci'ni seçin. Aşağıda, bu öğretici için her alanın değerlerini görebilirsiniz.
Alan Değer
Belirteç Adı Belirteciniz için bir ad
Verme Türü Yetki Kodu
Geri arama URL'si https://www.getpostman.com/oauth2/callback
Kimlik Doğrulama URL'si https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME.azurehealthcareapis.com>
Erişim Belirteci URL'si https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token
Client ID Önceki adımlarda kopyaladığınız istemci kimliği
İstemci Gizli Anahtarı <BOŞ>
Kapsam <BOŞ>
State 1234
İstemci Kimlik Doğrulaması İstemci kimlik bilgilerini gövdede gönderme
  1. Kimlik bilgilerinizle oturum açın ve Kabul Et'i seçin
  2. Sonucu aşağı kaydırın ve Belirteci Kullan'ı seçin
  3. En üstten Yeniden Gönder'i seçtiğinizde bu kez bir sonuç almanız gerekirBaşarılı Hasta

Hastayı FHIR sunucusuna gönderme

Artık erişiminiz var, yeni bir hasta oluşturabilirsiniz. FHIR sunucunuza ekleyebileceğiniz basit bir hastanın örneği aşağıda verilmişti. Bunu json Postman'in Gövde bölümüne girin.

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

Bu POST, FHIR sunucunuzda James Tiberious Kirk adlı yeni bir hasta oluşturacak. Hasta Sonrası

Bir hastayı yeniden almak için GET komutunu yaparsanız çıkışta James Tiberious Kirk'ün listelendiğini görürsünüz.

Not

FHIR için Azure API'sine istek gönderirken, içerik türü üst bilgisini application/json

Erişim sorunlarını giderme

Bu adımlardan herhangi biri sırasında sorunlarla karşılaştıysanız Microsoft Entra Id ve FHIR için Azure API'de bir araya topladığımız belgeleri gözden geçirin.

  • Microsoft Entra Id ve FHIR için Azure API - Bu belgede, Microsoft Entra Id'nin temel ilkelerinden bazıları ve FHIR için Azure API'si ile nasıl etkileşime geçtiğinin ana hatlarıyla açıklanmaktadır.
  • Erişim belirteci doğrulaması - Bu nasıl yapılır kılavuzu, erişim belirteci doğrulaması hakkında daha ayrıntılı bilgiler ve erişim sorunlarını çözmek için atılması gereken adımlar sunar.

Sonraki Adımlar

artık istemci uygulamanıza başarıyla bağlanabildiğiniz için web uygulamanızı yazmaya hazırsınız.

FHIR®, HL7'nin tescilli ticari markasıdır ve HL7'nin izniyle kullanılır.