事件通知 Web 服务

“亚马逊事件通知 Web 服务”允许您启用第三方软件应用程序,并安全可靠的从您的账户检索事件信息。 使用“事件通知 Web 服务 (ENS)”,您的软件应用程序可检索您账户中与事件有关的通知。现在可通过该服务获得订单通知,声明和付款等其他类型的账户事件通知将于后期提供。


重要概念

有两个重要概念可帮助您理解并使用“事件通知 Web 服务”。这些概念在相关“帮助”页面中普遍使用。

  • 事件? 事件是指账户活动。例如包括对您的某一个产品下订单、向您的付款账户支付款项或者客户提出索赔。

  • 页面和分页 Cookie? “事件通知 Web 服务”允许您将对一系列事件的检索划分为一系列网页。每个页面包含一个分页 Cookie,其将保存您在一系列事件中的位置,这就像在书中插入书签一样。通过保存分页 Cookie,您的应用程序随后可检索到额外的事件页面,而不会丢失其位置和遗漏或重复事件。分页 Cookie 还包括其他两个字段:“使用期限”和“退避时间”。“使用期限”字段定义了该分页 Cookie 的使用期限。分页 Cookie 必须在“使用期限”所定义的时间期限过期之前使用,否则它将会过期并失效。“退避时间”定义了客户在启用新分页 Cookie 之前必须等待的时间长度。如果在“退避时间”到期之前启用分页 Cookie,服务将拒绝请求。这通过对最繁忙的客户进行节流并使之降至更平稳可持续的水平,从而能确保所有客户均拥有访问该服务的公平机会。


亚马逊官网原文详情:   

Event Notification Web Service

The Amazon Event Notification Web Service (ENS) allows you to enable third-party software applications to retrieve event information from your account in a reliable and secure manner.

With the ENS, your software application can retrieve notifications about events in your account. Order notifications are available through this service and other types of account event notifications, such as for claims and payments, will be available in the future.


Important Event Notification Web Service Concepts

There are two important concepts that will help you understand and use the Event Notification Web Service. These concepts are used throughout the related Help pages.

Events

Events are account activities. Examples include an order being placed for one of your products, funds being disbursed to your Payments account, or a claim being filed by a customer.

Pages and PagingCookies

The Event Notification Web Service allows you to break the retrieval of a series of events into a sequence of pages. Each page includes a PagingCookie which saves your place in the series of events, much like a bookmark does in a book. By saving this PagingCookie, your application can then retrieve additional pages of events later without losing its place and missing or duplicating events. A PagingCookie also includes two extra fields: TimeToLive and BackOffTime. The TimeToLive field defines the lifespan of this PagingCookie. The PagingCookie must be used before the amount of time specified in TimeToLive has passed, or it will expire and become invalid. The BackOffTime specifies how long a client must wait before using a new PagingCookie. If a PagingCookie is used before the amount of time specified in BackOffTime has passed, the service will reject the request. This ensures that all clients are given a fair chance to access the service by throttling the busiest clients down to a more sustainable level.


文章来源:亚马逊官方网站

(本文内容根据网络资料整理,出于传递更多信息之目的,不代表连连国际赞同其观点和立场)