71
亚马逊"事件通知 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中指定的"退避时间"。
