Aracılığıyla paylaş


Postman'i Azure Digital Twins için yapılandırma

Önemli

Azure Digital Twins hizmetinin yeni bir sürümü yayınlandı. Yeni hizmetin genişletilmiş özellikleri ışığında özgün Azure Digital Twins hizmeti (bu belge kümesinde açıklanmıştır) kullanımdan kaldırılmıştır.

Yeni hizmetin belgelerini görüntülemek için etkin Azure Digital Twins Belgeleri'ni ziyaret edin.

Bu makalede, Postman REST istemcisinin Azure Digital Twins Yönetim API'leriyle etkileşime geçmek ve bunları test etmek için nasıl yapılandırıldığı açıklanır. Özellikle şunları açıklar:

  • Azure Active Directory uygulamasını OAuth 2.0 örtük izin akışını kullanacak şekilde yapılandırma.
  • Postman REST istemcisini kullanarak Yönetim API'lerinize belirteç taşıyan HTTP istekleri gönderme.
  • Postman'i kullanarak Yönetim API'lerinize çok parçalı POST istekleri gönderme.

Postman özeti

Yerel test ortamınızı hazırlamak için Postman gibi bir REST istemci aracı kullanarak Azure Digital Twins'i kullanmaya başlayın. Postman istemcisi, karmaşık HTTP isteklerinin hızla oluşturulmasına yardımcı olur. www.getpostman.com/apps giderek Postman istemcisinin masaüstü sürümünü indirin.

Postman , önemli HTTP isteği işlevlerini kullanışlı bir masaüstü ve eklenti tabanlı GUI'de bulan bir REST test aracıdır.

Postman istemcisi aracılığıyla, çözüm geliştiricileri HTTP isteğinin türünü (POST, GET, UPDATE, PATCH ve DELETE), çağrılacak API uç noktasını ve TLS kullanımını belirtebilir. Postman ayrıca HTTP isteği üst bilgileri, parametreler, form verileri ve gövdeler eklemeyi de destekler.

Azure Active Directory'yi OAuth 2.0 örtük izin akışını kullanacak şekilde yapılandırma

  1. Azure Active Directory uygulaması oluşturmak ve yapılandırmak için Hızlı Başlangıç'taki adımları izleyin. Alternatif olarak, mevcut bir uygulama kaydını yeniden kullanabilirsiniz.

    Yeni bir Postman Yeniden Yönlendirme URI'sini yapılandırma

  2. Şimdi adresine yeniden yönlendirme URI'sinihttps://www.getpostman.com/oauth2/callbackekleyin.

  3. OAuth 2.0 örtük izin akışının kullanılmasına izin vermek için ÖrtükErişim belirteçleri onay kutusunu seçin.> Yapılandır'ı ve ardından Kaydet'i seçin.

  4. Azure Active Directory uygulamanızın İstemci Kimliğini kopyalayın.

OAuth 2.0 belirteci alma

Aşağıdaki örneklerde Digital YOUR_MANAGEMENT_API_URL Twins API'lerinin URI'sine başvurur:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/api/v1.0
Name Şununla değiştir
YOUR_INSTANCE_NAME Azure Digital Twins örneğinizin adı
YOUR_LOCATION Örneğinizin barındırılıyor olduğu bölge

Azure Active Directory belirtecini almak için Postman'i ayarlayın ve yapılandırın. Daha sonra, alınan belirteci kullanarak Azure Digital Twins'e kimliği doğrulanmış bir HTTP isteği gönderin:

  1. Yetkilendirme URL'nizin doğru olduğunu doğrulayın. Şu biçimi almalıdır:

    https://login.microsoftonline.com/YOUR_AZURE_TENANT.onmicrosoft.com/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0
    
    Name Şununla değiştir Örnek
    YOUR_AZURE_TENANT Kiracınızın veya kuruluşunuzun adı. Azure Active Directory uygulama kaydınızın alfasayısal Kiracı Kimliği yerine insan dostu adı kullanın. microsoft
  2. Uygulamayı indirmek için www.getpostman.com gidin.

  3. GET isteğinde bulunmak istiyoruz. Yetkilendirme sekmesini seçin, OAuth 2.0'ı ve ardından Yeni Erişim Belirteci Al'ı seçin.

    Alan Değer
    Veriliş Türü Implicit
    Geri Çağırma URL’si https://www.getpostman.com/oauth2/callback
    Kimlik Doğrulama URL’si 1. adımdakiYetkilendirme URL'sini kullanma
    İstemci Kimliği Önceki bölümde oluşturulan veya yeniden kullanılan Azure Active Directory uygulamasının Uygulama Kimliği'ni kullanın
    Kapsam Boş bırakın
    Durum Boş bırakın
    İstemci Kimlik Doğrulaması Send as Basic Auth header
  4. İstemci artık şu şekilde görünmelidir:

    Postman istemci belirteci örneği

  5. Belirteç İste’ye tıklayın.

  6. Ekranı aşağı kaydırın ve Belirteci Kullan'ı seçin.

Çok parçalı POST isteği oluşturma

Önceki adımları tamamladıktan sonra Postman'i kimliği doğrulanmış bir HTTP çok parçalı POST isteği yapacak şekilde yapılandırın:

  1. Üst Bilgiler sekmesinin altında, değeriyle multipart/mixedcontent-Type HTTP isteği üst bilgi anahtarı ekleyin.

    İçerik türünü çok parçalı/karma olarak belirtin

  2. Metin olmayan verileri dosyalar halinde seri hale getirme. JSON verileri JSON dosyası olarak kaydedilir.

  3. Gövde sekmesinin altında öğesini seçinform-data.

  4. Bir anahtar adı atayarak ve öğesini seçerek Fileher dosyayı ekleyin.

  5. Ardından, Dosya Seç düğmesi aracılığıyla her dosyayı seçin.

    Postman istemci formu gövde örneği

    Not

    • Postman istemcisi, çok parçalı öbeklerin el ile atanmış content-type veya content-disposition olmasını gerektirmez.
    • Her bölüm için bu üst bilgileri belirtmeniz gerekmez.
    • İsteğin tamamı için uygun bir İçerik Türü seçmeniz veya başka bir İçerik Türü seçmeniz multipart/mixed gerekir.
  6. Son olarak, çok parçalı HTTP POST isteğinizi göndermek için Gönder'i seçin. veya 201 durum kodu 200 başarılı bir isteği gösterir. İstemci arabiriminde uygun yanıt iletisi görüntülenir.

  7. API uç noktasını çağırarak HTTP POST istek verilerinizi doğrulayın:

    YOUR_MANAGEMENT_API_URL/spaces/blobs?includes=description
    

Sonraki adımlar