X-RateLimit-Limit
术语定义:在当前时间窗口内,客户端可发送的最大请求总数量。
与工具关系:解析器会自动提取此字段并在仪表盘上作为总配额基准值,用于计算使用率百分比。例如 GitHub 认证用户的 Limit 通常为 5000。
X-RateLimit-Remaining
术语定义:当前时间窗口内剩余可用的请求次数。
与工具关系:工具将此字段作为仪表盘的核心指标之一,实时显示剩余量,并据此计算使用率。当此值为 0 时表示配额已用尽。
X-RateLimit-Reset
术语定义:配额重置的时间点,通常为 Unix 时间戳(秒数)。
与工具关系:解析器会自动将 Unix 时间戳转换为可读的日期时间格式,并在仪表盘上显示倒计时。同时支持相对秒数格式的自动识别。
X-RateLimit-Used
术语定义:当前时间窗口内已使用的请求次数。
与工具关系:工具会自动提取此字段并在仪表盘上以条形图展示已使用量。部分 API 只返回 Limit 和 Remaining,不包含 Used,此时工具会自动通过 Limit - Remaining 计算。
Retry-After
术语定义:达到速率限制后,建议客户端等待的秒数(或 HTTP 日期)再重试。
与工具关系:当解析到 Retry-After 字段时,仪表盘会显示“Retry-After: X 后可重试”的提示信息。支持纯数字秒数和 HTTP 日期两种格式。
X-RateLimit-Resource
术语定义:标识速率限制适用于哪种资源类型的字段。
与工具关系:不同 API 平台可能对不同资源设置不同的速率限制。例如 GitHub 对 core、search、graphql 资源分别限制。本工具会解析此字段并在详情表中展示。
Rate Limiting
术语定义:速率限制,服务端对客户端在特定时间窗口内可发送请求数量的上限。
与工具关系:本工具的核心目的就是帮助开发者理解和监控 API 的速率限制状态。通过分析响应头中的 RateLimit 字段,开发者可以及时了解配额使用情况,避免触发 429 错误。
HTTP 429
术语定义:Too Many Requests,表示客户端发送请求过快,超出服务端允许的速率限制。
与工具关系:工具的 429 重试预设模拟了触发速率限制后的响应头,帮助开发者理解这种场景下的响应头格式和应对策略。通常配合 Retry-After 头使用。
时间窗口
术语定义:速率限制的计时区间,常见的有固定窗口(每分钟、每小时)和滑动窗口。
与工具关系:工具在参考表中展示了不同平台的时间窗口设置,例如 GitHub 为 1 小时滚动窗口,Discord 为 1 秒全局窗口。理解窗口机制有助于合理规划请求节奏。
UD5工具箱