Özel bağlayıcı için Postman koleksiyonu oluşturma

Postman, HTTP istekleri yapmak için bir uygulamadir ve Postman koleksiyonları ile ilgili API isteklerini düzenlemenize ve gruplandırmanıza yardımcı olur. Koleksiyonlar, API’niz için OpenAPI tanımına sahip olmadığınızda özel bağlayıcı geliştirmesini daha hızlı ve kolay hale getirir. Koleksiyonlar hakkında daha fazla bilgi için bkz. Postman belgelerinde koleksiyonlar oluşturma.

Bu konu, tüm öğretici hizmetler metin analizi API'sinden istek ve yanıt içeren bir koleksiyon oluşturursunuz. İlgili bir konu, bu koleksiyonu kullanarak bir bağlayıcı oluşturursunuz.

Ön koşullar

• Postman uygulaması
• Bilişsel Hizmetler Metin Analizleri API’si için bir API anahtarı.

API için bir HTTP isteği oluşturma

1. Postman’de, Oluşturucu sekmesi üzerinde, HTTP yöntemini seçin, API uç noktası için istek URL'sini girin ve varsa bir yetkilendirme protokolü seçin.

   

   Parametre	Value
   HTTP yöntemi	"GÖNDERİ"
   İstek URL'si	"https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment"
   Yetkilendirme	"Yetkilendirme Olmasın" (sonraki adımda bir API anahtarı belirtirsiniz)

2. İstek üst bilgisi için anahtar-değer çiftlerini girin. Ortak HTTP üst bilgileri için, açılan listeden seçebilirsiniz.

   

   Tuş	Value
   Ocp-Apim-Subscription-Key	Bilişsel Hizmetler hesabınızda bulabileceğiniz API-abonelik-anahtarınız
   Content-Type	"uygulama/json"

3. İstek gövdesinde göndermek istediğiniz içeriği girin. İsteğin, yanıt alarak çalışıp çalışmadığını denetlemek için Gönder’i seçin.

   

   {
       "documents": [{
           "language": "en-us",
           "id": "1", 
           "text": "I enjoyed the new movie after a long day."
       }]
   }
   

   Yanıt alanı, sonuç ve oluşmuşsa hata da dahil olmak üzere API'den gelen tam yanıtı içerir.

   

HTTP istekleri hakkında daha fazla bilgi için bkz. Postman belgelerinde İstekler.

Koleksiyonu kaydetme

1. Kaydet'i seçin.

   

2. İsteği Kaydet’in altında, bir istek adı ve istek açıklaması girin. Özel bağlayıcı, API işlem özeti ve açıklaması için bu değerleri kullanır.

   

   Parametre	Value
   İstek adı	"DetectSentiment"
   İstek açıklaması	"API, 0 ile 1 arasında sayısal bir puan döndürür. 1'e yaklaşan puanlar olumlu yaklaşımı ve 0'a yaklaşan puanlar olumsuz yaklaşımı gösterir."

3. + Koleksiyon Oluştur'u seçin ve bir koleksiyon adı sağlayın. API'yi çağırdığınızda özel bağlayıcı bu değeri kullanır. Onay işaretini seçerek bir koleksiyon klasörü oluşturun, sonra SentimentDemo Konumuna Kaydet’i seçin.

   

   Parametre	Value
   Koleksiyon adı	"SentimentDemo"

İstek yanıtını kaydetme

İsteğinizi kaydettiğinize göre artık yanıtı da kaydedebilirsiniz. Böylelikle, isteği daha sonra yüklediğinizde yanıt örnek olarak görüntülenir.

1. Yanıt penceresinin üzerinde, Yanıtı Kaydet’i seçin.

   

   Özel bağlayıcılar, istek başına yalnızca bir yanıt destekler. İstek başına birden çok yanıt kaydederseniz yalnızca ilk yanıt kullanılır.

2. Uygulamanın üst kısmında, örnek yanıtınız için bir ad sağlayın ve Örneği Kaydet’i seçin.

   

API'nizin ek özellikleri olsaydı Postman koleksiyonunuzu tüm ek istekler ve yanıtlarla birlikte oluşturmaya devam ederdiniz.

Postman koleksiyonunu dışarı aktarma

Şimdi koleksiyonu, özel bağlayıcı sihirbazını kullanarak içeri aktarmak üzere bir JSON dosyası olarak dışarı aktarabilirsiniz. Koleksiyonu dışarı aktarmadan önce içerik türünü ve güvenlik üst bilgilerini kaldırın. Bunlar API isteği yapmak için gerekir ancak özel bağlayıcıda farklı bir şekilde işlenirler.

1. Üst Bilgiler'in altında, her üst bilginin üzerine gelin ve kaldırmak için üst bilginin yanındaki X işaretini seçin. Koleksiyonu yeniden kaydetmek için Kaydet’i seçin.

   

2. Koleksiyonun yanındaki üç noktayı (. . . .) ve ardından Dışarı aktar'ı seçin.

   

3. Collection v1 dışarı aktarma biçimini seçin, Dışarı aktar'ı seçin, sonra da JSON dosyasını kaydetmek istediğiniz konuma göz atın.

   

   Not

   Şu anda, özel bağlayıcılar için yalnızca v1 koleksiyonlarını kullanabilirsiniz.

Sonraki adımlar

Şimdi oluşturduğunuz Postman koleksiyonuna dayalı olarak özel bir bağlayıcı tanımlamaya hazırsınız:

• Bir Postman koleksiyonundan özel bağlayıcı oluşturma