服务到服务 Microsoft Store API 的细化速率限制

Xbox 服务实现细化速率限制 (FGRL)，这包括通过服务到服务调用在商业方案中使用的集合和库存终结点。 请确保服务处理速率限制和限制 HTTP 响应代码，如下所述。

受影响的终结点

以下终结点强制实施 FGRL 限制：

• https://collections.mp.microsoft.com/v9.0/collections/publisherQuery

• https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview

• https://collections.mp.microsoft.com/v8.0/collections/consume

• https://purchase.mp.microsoft.com/v8.0/b2b/orders/query

• https://purchase.mp.microsoft.com/v7.0/purchases/grant

• https://purchase.mp.microsoft.com/v8.0/b2b/recurrences/query

• https://purchase.mp.microsoft.com/v8.0/b2b/recurrences/{recurrenceId}/change

以下 GDK API 使用这些终结点：

• XStoreQueryAssociatedProductsAsync

• XStoreQueryProductsAsync

• XStoreQueryEntitledProductsAsync

速率限制

与 Xbox 服务一样，速率限制是 XStore* 客户端 API 的用户 + 游戏 ID 的组合：

• {userId;titleId}：限制为 100 个操作/300 秒。

除了用户上下文之外，商务终结点还包括 PublisherID 标志，该标志用于服务到服务调用的速率限制：

• {userId;publisherId}：限制为 200 个操作/300 秒。

仅对持续流量强制实施限制，不强制实施突发速率限制。

速率限制行为

与实时服务调用的现有速率限制一样，对受限商务呼叫的速率限制将返回 HTTP 429 错误。 此错误的响应正文包含以下格式的其他信息：已超出 {Z} 方面 {Y} 秒内 {X} 操作的速率限制。

响应标头还将包含“Retry-After”标头，以指示何时允许下一次调用。

若要避免受到速率限制，请分析调用模式以确定何时调用会超出现有调用限制。 然后尽可能限制或减少调用，并实现逻辑以遵循 Retry-After 标头。

另请参阅

细化速率限制