⚙️ Rate Limit（速率限制）說明

背景說明

部分停車場因地理環境或系統因素，可能發生 非預期的連續呼叫 Autopass API 的情況。
常見原因如下：

攝影機畫面中出現與車牌號碼相似的物件，誤觸發 API 呼叫

停車場系統發生程式錯誤，導致重複請求或無窮迴圈

為確保系統穩定性與使用者體驗，Autopass 在以下 API 實作了 速率限制（Rate Limit） 機制：

每次 API 請求時，系統會根據請求內容計算出一個「計算單位（Rate Limit Key）」，用以統計請求次數。

若在 1 分鐘內，相同計算單位的請求次數超過 5 次，即觸發限流機制。

一旦觸發限流，該計算單位將被暫時封鎖 60 分鐘，封鎖期間所有同單位的請求都會被拒絕。

⚠️ 此設定值為常態配置。但當遭遇外部異常時，Autopass 將依事故影響範圍動態調整此設定

於封鎖期間收到相同 計算單位（Rate Limit Key） 的 Http request 時，將返回 Http Status 429（TOO_MANY_REQUESTS）的 Response 並不執行任何業務邏輯。

# Http Status 429 with this Http Body 
{
    "error": {
        "code": "TOO_MANY_REQUESTS",
        "message": "TOO_MANY_REQUESTS"
    }
}

以下三項資訊相同時，視為同一個計算單位：

停車場識別（Auth Token）

車輛識別鍵值（車牌號碼或停車紀錄 ID）

API 類型（進場、離場、請款）

此組合用於判斷是否觸發限流，以及限制範圍與時間。

範例：

每個計算單位皆獨立統計與封鎖，
限流的狀態與解除時間互不影響，確保其他車輛或行為不受波及。