速率限制

什麼是速率限制？

購物 API 依賴於中央庫存管理系統。由於該系統容量有限，因此需要防止過度使用，以確保符合所有合作夥伴和 Expedia Group 品牌的利益。

我們對合作夥伴可以請求的流量限制在合理的範圍，以實現流量最佳化。這些速率限制確保我們能夠為合作夥伴提供穩定且不間斷的服務，同時保證 Expedia Group 系統的使用效率。

對於商店流量，決定負載的重要因素是每個請求中搜尋的飯店數量、客房數量和住宿天數；即，負載 = (購物資源呼叫中的) 旅宿數量 x 客房數量 x 住宿晚數。

我們在大多數回應中包含一些標頭，以幫助您了解您的呼叫所產生的負載。我們盡可能在更多的回應中包含完整的標頭集合，但不能保證在每個回應中提供，因此請適當規劃：

參數 (標頭)	說明	值
`Rate-Limit-Day-Remaining`	每日時段剩餘額度 (單位：百分比) 的標頭 (選用)。	數字
`Rate-Limit-Day-Reset`	時間戳記的標頭，該時間戳記可在每日重設額度時反映自 Unix epoch 起，已經過多少毫秒 (選用)。	數字
`Rate-Limit-Minute-Remaining`	每分鐘時段剩餘額度 (單位：百分比) 的標頭 (選用)。	數字
`Rate-Limit-Minute-Reset`	時間戳記的標頭，該時間戳記可在每分鐘重設額度時反映自 Unix Epoch 起，已經過多少毫秒 (選用)。	數字
`Rate-Limit-Reduction-Status`	所有每日額度用完時，會觸發表示每分鐘額度減少狀態 (非使用中、使用中) 的標頭 (選用)。	字串

當您用完每日負載配額時，速率限制會將您的每分鐘速率限制降低 80%。如果超出了每日速率限制，您將看到 HTTP 429 錯誤代碼。

範例：

{
 "type": "too_many_requests",
 "message": "You have reached your capacity for this type of request."
}

這取決於您在一天中的什麼時候超出每日限制。如果是當天稍晚的時間，您的流量已經逐漸減少，那麼影響可能很小。

超過限制的合作夥伴可以採取以下操作來最佳化流量，並維持在分配的限制範圍內以避免發生速率限制。

透過以下方式減少流量負載：

透過以下方式增加預訂及營收：

Expedia Group 每月計算現有合作夥伴的每日速率限制，將合作夥伴在一段期間內 (通常為 3 個月) 的流量與收入納入考量，以反映季節性因素。

新合作夥伴在前 3 個月內將享有更大的限額，以確保業績順利成長。前 3 個月結束後，將適用標準的速率限制計算。

合作夥伴在即將舉辦促銷活動時，或者正在執行使用量最佳化工作時，可以請求暫時提高速率限制，以避免速率限制。這些暫時提高的速率限制只供短期使用。如果您覺得需要暫時提高速率限制，請聯絡您的 Partner Connect 代表以獲取更多資訊。