亚马逊"事件通知 Web 服务"为开发者提供了四种主要的操作功能。其中两种用于检索与事件类型相关的一般信息,另外两种则用于获取事件通知本身。本文将对这四种操作进行详细介绍,帮助开发者更好地利用该服务。

事件类型是否受支持

该操作允许开发者检查"事件通知 Web 服务"是否支持所提供的事件类型。

操作名称: IsEventTypeSupported

请求参数:

EventType(必须): 包含事件类型名称的字符串

响应:

IsSupported(必须): 一个布尔值,表示该事件类型是否受支持

获取受支持事件类型

该操作可以让开发者检索所有受支持事件类型的列表及其描述。

操作名称: GetSupportedEventTypes

请求参数:

MatchString(必须): 包含兼容 Java/Perl 正则表达式的字符串,用于与事件类型名称相匹配。如果输入了空字符串,将返回所有事件类型的数据。

响应:

事件类型信息,包括事件类型、名称和描述

获取事件

该操作允许开发者检索事件页面和分页 Cookie,可用于后续获取更多事件。

操作名称: GetEvents

请求参数:

EventType(必须): 要检索的事件类型

• StartDate(可选): 我们需要返回事件结果的最早日期

• Limit(可选): 限制返回的事件数量

• EventsPerPage(可选): 每次调用时返回的事件数量

响应:

事件通知:包括事件类型、时间戳和 XML 主体

• 分页 Cookie:用于后续获取更多事件

• 存在更多页:是否还有可检索的其他事件页

获取更多

该操作可以使用之前获取的分页 Cookie 来检索额外的事件,但需要等待"退避时间"后再调用。

操作名称: GetMore

请求参数:

PagingCookie(必须): 之前调用"获取事件"或"获取更多"时返回的分页 Cookie

• EventsPerPage(可选): 每次调用时返回的事件数量

响应:

事件通知:包括事件类型、时间戳和 XML 主体

• 分页 Cookie:用于后续获取更多事件

• 存在更多页:是否还有可检索的其他事件页

FQAs:

Q: 如果我想检查"订单已发货"这个事件类型是否受支持,应该怎么做?

A: 可以调用"事件类型是否受支持"操作,将"订单已发货"作为EventType参数传入,检查IsSupported响应是否为true。

Q: 如果我想获取所有受支持的事件类型及其描述,应该怎么做?

A: 可以调用"获取受支持事件类型"操作,将空字符串作为MatchString参数传入,即可获取所有受支持事件类型的信息。

Q: 如果我只想获取最近500个"订单已发货"事件,应该怎么做?

A: 可以调用"获取事件"操作,将"订单已发货"作为EventType参数传入,并设置Limit参数为500。这样就可以获取最近500个"订单已发货"事件。

Q: 如果我想继续获取后面的事件,应该怎么做?

A: 调用"获取更多"操作,传入之前"获取事件"操作返回的分页Cookie。这样就可以继续获取后面的事件。需要注意的是,在调用"获取更多"之前,需要等待分页Cookie中指定的"退避时间"。