Tarayıcıdan API çağrısı yapmaCall API from a browser

Bu makale, Azure Özel Karar Alma Hizmeti API 'Lerine doğrudan bir tarayıcıdan çağrı yapmanıza yardımcı olur.This article helps you make calls to the Azure Custom Decision Service APIs directly from a browser.

Önce uygulamanızıkaydettiğinizden emin olun.Be sure to Register your application, first.

Başlayalım.Let's get started. Uygulamanız bir ön sayfa olarak modellenmiştir ve bu, çeşitli makale sayfalarına bağlanır.Your application is modeled as having a front page, which links to several article pages. Ön sayfa, makale sayfalarının sıralamasını belirtmek için Özel Karar Alma Hizmeti kullanır.The front page uses Custom Decision Service to specify the ordering of its article pages. Ön sayfanın HTML kafasını aşağıdaki kodu ekleyin:Insert the following code into the HTML head of the front page:

// Define the "callback function" to render UI
<script> function callback(data) { … } </script>

// call Ranking API, after callback() is defined
<script src="https://ds.microsoft.com/api/v2/<appId>/rank/<actionSetId>" async></script>

data Bağımsız değişkeni, işlenecek URL 'lerin sıralamasını içerir.The data argument contains the ranking of URLs to be rendered. Daha fazla bilgi için bkz. başvuru API 'si.For more information, see the reference API.

Bir kullanıcıyı işlemek için en üstteki makaleye tıklayın, ön sayfada aşağıdaki kodu çağırın:To handle a user click on the top article, call the following code on the front page:

// call Reward API to report a click
$.ajax({
    type: "POST",
    url: '//ds.microsoft.com/api/v2/<appId>/reward/' + data.eventId,
    contentType: "application/json" })

Burada, data callback() işlevinin bağımsız değişkenidir.Here, data is the argument to the callback() function. Bu öğreticidebir uygulama örneği bulunabilir.An implementation example can be found in this tutorial.

Son olarak, Özel Karar Alma Hizmeti tarafından kabul edilecek makalelerin (Eylemler) listesini döndüren eylem kümesi API 'sini sağlamanız gerekir.Finally, you need to provide the Action Set API, which returns the list of articles (actions) to be considered by Custom Decision Service. Bu API 'yi bir RSS akışı olarak aşağıda gösterildiği gibi uygulayın:Implement this API as an RSS feed, as shown here:

<rss version="2.0">
<channel>
   <item>
      <title><![CDATA[title (possibly with url) ]]></title>
      <link>url</link>
      <pubDate>Thu, 27 Apr 2017 16:30:52 GMT</pubDate>
    </item>
   <item>
       ....
   </item>
</channel>
</rss>

Burada, her üst düzey <item> öğe bir makale açıklar.Here, each top-level <item> element describes an article. <link> Zorunludur ve özel karar alma hizmeti tarafından bir eylem kimliği olarak kullanılır.The <link> is mandatory and is used as an action ID by Custom Decision Service. 15 <date> ' ten fazla makaleleriniz varsa belirtin (Standart bir RSS biçiminde).Specify <date> (in a standard RSS format) if you have more than 15 articles. En son 15 makale kullanılır.The 15 most recent articles are used. , <title> İsteğe bağlıdır ve makale için metinle ilgili özellikler oluşturmak için kullanılır.The <title> is optional and is used to create text-related features for the article.

Sonraki adımlarNext steps

  • Daha ayrıntılı bir örnek için öğreticide çalışın.Work through a tutorial for a more in-depth example.
  • Belirtilen işlevsellik hakkında daha fazla bilgi edinmek için başvuru API 'sine başvurun.Consult the reference API to learn more about the provided functionality.