logo
GeekFormat

Rate Limit Header Parser

限流回應頭解析

同時相容新的 RateLimit-* 頭和常見的 X-RateLimit-* 頭,幫助你判斷剩餘額度、重置時間和重試窗口。

標準 RateLimit-*

1 個標準 limit 窗口reset: 18s
Window #1limit: 100window: 1m 0s
100;w=60

舊版 X-RateLimit-*

Limit
5000
Remaining
4991
Used
9
Reset (epoch)
2025/04/14 16:00:00
Retry-After
1m 0s
Resource
-

JSON 預覽

{
  "headers": {
    "x-ratelimit-limit": [
      "5000"
    ],
    "x-ratelimit-remaining": [
      "4991"
    ],
    "x-ratelimit-used": [
      "9"
    ],
    "x-ratelimit-reset": [
      "1744617600"
    ],
    "retry-after": [
      "60"
    ],
    "ratelimit-limit": [
      "100;w=60"
    ],
    "ratelimit-remaining": [
      "25"
    ],
    "ratelimit-reset": [
      "18"
    ]
  },
  "standard": {
    "limit": [
      {
        "raw": "100;w=60",
        "amount": 100,
        "windowSeconds": 60,
        "parameters": {
          "w": "60"
        }
      }
    ],
    "remaining": [
      {
        "raw": "25",
        "amount": 25,
        "windowSeconds": null,
        "parameters": {}
      }
    ],
    "reset": "18",
    "policy": ""
  },
  "legacy": {
    "limit": "5000",
    "remaining": "4991",
    "used": "9",
    "reset": "1744617600",
    "resource": "",
    "retryAfter": "60",
    "retryAfterSeconds": 60
  }
}

線上看限流標頭,429 到底卡在哪一眼就知道。

相關推薦

適用場景

  • 介面頻繁回傳 429 時,先拆解限流回應標頭判斷是額度用完還是節流視窗未結束
  • 呼叫第三方 API 時查看剩餘請求次數和重設時間規劃呼叫頻率
  • 設計介面重試策略時參考限流視窗大小和 Retry-After 延遲時間
  • 同步限流規則給團隊成員說明配額和頻控邏輯避免重複觸發限流

功能特點

  • 配額、視窗、重設時間分開看:限流資訊不再擠在一起
  • 第三方 API 除錯更直接:知道還能調幾次、多久恢復、要不要重試
  • 配額資訊直觀:幫助查看視窗大小、剩餘次數和恢復時間
  • 開發串接友好:方便把限流規則快速講清楚並同步給介面呼叫方

使用方法

  1. 貼上 RateLimit 或 X-RateLimit 回應標頭內容到輸入區
  2. 工具自動解析限流視窗、剩餘次數、重設時間和 Retry-After 欄位
  3. 查看配額資訊和限流策略說明確認目前呼叫狀態
  4. 根據解析結果調整呼叫頻率或設計退避重試策略

常見問題

為什麼介面會回傳 429 Too Many Requests?

429 通常說明請求頻率超過了伺服器端限制。把 RateLimit 或 X-RateLimit 資訊拆解後,就能看清賸餘額度和恢復時間。

Retry-After 和重設時間有什麼區別?

Retry-After 更偏向告知多久後再試,重設時間則更接近限流視窗恢復節點。結合查看能更準確安排重試策略。

適合排查第三方 API 的呼叫配額問題嗎?

非常適合。無論是開放平台、支付介面還是雲端服務 API,很多都會透過回應標頭回傳配額資訊。

可以幫助做介面重試策略設計嗎?

可以。理解剩餘次數、限流視窗和恢復時間後,更容易制定退避、排隊和重試策略。