API 速率限制

什麼是速率限制？

速率限制是指對 API 在特定時間段內所能處理的請求數量設定上限的做法。分析 API 仰賴一個中央庫存管理系統，而該系統的處理能力是有限的。限制同時允許的流量，可保護系統免受 over-utilization, 的侵害，這對 Expedia 及其合作夥伴皆有益處。

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

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

參數 (標頭)	說明	值
`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 個月結束後，將適用標準的速率限制計算。

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