logo
GeekFormat

Rate Limit Header Parser

Bộ phân tích tiêu đề giới hạn tỷ lệ

Tương thích với cả tiêu đề RateLimit-* mới và tiêu đề X-RateLimit-* phổ biến, giúp bạn xác định hạn ngạch còn lại, thời gian đặt lại và cửa sổ thử lại.

Tiêu chuẩn RateLimit-*

1 cửa sổ giới hạn tiêu chuẩnđặt lại: 18s
Window #1limit: 100cửa sổ: 1m 0s
100;w=60

Kế thừa X-RateLimit-*

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

Xem trước 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
  }
}

Xem header giới hạn tần suất trực tuyến, 429 kẹt ở đâu nhìn là biết.

Đề xuất Liên quan

Trường hợp sử dụng

  • Khi API liên tục trả 429, trước tiên tách header giới hạn để đánh giá hết hạn ngạch hay cửa sổ throttle chưa kết thúc
  • Xem số request còn lại và thời gian reset khi gọi API bên thứ ba để lên kế hoạch tần suất gọi
  • Tham khảo cửa sổ giới hạn tần suất và thời gian trễ Retry-After khi thiết kế chiến lược retry API
  • Đồng bộ rule giới hạn tần suất cho thành viên nhóm, giải thích logic hạn ngạch và kiểm soát tần suất, tránh kích hoạt giới hạn lặp lại

Tính năng

  • Hạn ngạch, cửa sổ, thời gian reset tách riêng: Thông tin giới hạn không còn dồn đống
  • Xử lý lỗi API bên thứ ba trực tiếp hơn: Biết còn gọi được mấy lần, bao lâu phục hồi, có nên thử lại không
  • Thông tin hạn ngạch trực quan: Giúp xem kích thước cửa sổ, số lần còn lại và thời gian phục hồi
  • Thân thiện tích hợp phát triển: Tiện nói rõ rule giới hạn tần suất và đồng bộ cho bên gọi API

Cách Sử dụng

  1. Dán nội dung header RateLimit hoặc X-RateLimit vào vùng nhập
  2. Công cụ tự động phân tích cửa sổ giới hạn, số lần còn lại, thời gian reset và trường Retry-After
  3. Xem thông tin hạn ngạch và mô tả chiến lược giới hạn, xác nhận trạng thái gọi hiện tại
  4. Điều chỉnh tần suất gọi hoặc thiết kế chiến lược retry lùi bước dựa trên kết quả phân tích

Câu hỏi Thường gặp

Tại sao API trả về 429 Too Many Requests?

429 thường cho biết tần suất request vượt quá giới hạn server. Sau khi tách thông tin RateLimit hoặc X-RateLimit, sẽ xem được hạn ngạch còn lại và thời gian phục hồi.

Retry-After và thời gian reset khác nhau thế nào?

Retry-After thiên về thông báo bao lâu nữa thử lại, thời gian reset thì gần với thời điểm cửa sổ giới hạn phục hồi. Kết hợp xem sẽ lên chiến lược retry chính xác hơn.

Có phù hợp xử lý vấn đề hạn ngạch gọi API bên thứ ba không?

Rất phù hợp. Dù là nền tảng mở, API thanh toán hay API cloud, nhiều bên đều trả thông tin hạn ngạch qua header phản hồi.

Có thể giúp thiết kế chiến lược retry API không?

Có thể. Sau khi hiểu số lần còn lại, cửa sổ giới hạn và thời gian phục hồi, sẽ dễ xây dựng chiến lược retry lùi bước, xếp hàng và retry hơn.