API 限流响应头解析器

粘贴HTTP响应头文本,自动解析GitHub/IETF草案/OpenAI等多种命名约定的限流信息,展示剩余配额、重置时间与使用百分比。

免费在线工具
Loading…

使用说明

  1. 把接口返回的HTTP响应头原始文本粘贴进输入框,每行一个 Header-Name: value 格式
  2. 点击「解析」,工具自动识别多种限流Header命名约定并分别展示每个维度的限额/剩余/重置信息
  3. 兼容识别:X-RateLimit-Limit/Remaining/Reset(GitHub风格)、RateLimit-Limit/Remaining/Reset(IETF draft标准,无X-前缀)、x-ratelimit-limit-requests与x-ratelimit-limit-tokens(OpenAI风格请求数/Token数双维度)
  4. Reset值如果是Unix时间戳会自动转换成可读时间,如果是较小的相对秒数会展示为「多少秒后重置」;同时识别Retry-After头(支持秒数和HTTP日期两种格式)
  5. 每个维度下方展示配额使用百分比进度条,直观查看还剩多少配额
  6. 点击「加载示例」可一键填入GitHub风格与OpenAI风格各一份示例响应头

功能介绍

  • 兼容解析四类主流限流Header命名约定:GitHub风格X-RateLimit-*、IETF draft标准RateLimit-*(无X-前缀)、OpenAI风格的x-ratelimit-*-requests与x-ratelimit-*-tokens双维度限流
  • Reset值智能判断:数值较大(类unix时间戳范围)自动转换为可读日期时间,数值较小则按相对秒数展示
  • 额外识别Retry-After响应头,支持纯数字秒数和HTTP-date两种格式
  • 自动计算并展示每个限流维度的配额使用百分比((limit-remaining)/limit),配合进度条直观呈现剩余额度
  • 未能识别的行会单独列出,方便核对粘贴内容是否完整

使用场景

调试GitHub API限流问题
粘贴GitHub API返回的X-RateLimit-*响应头,快速看到当前还剩多少请求配额、什么时候重置
监控OpenAI/Claude等AI API的双维度限流
AI API通常同时限制请求数和Token数两个维度,粘贴响应头后工具分别展示两个维度各自的剩余配额,避免只看一个维度漏判
对接遵循IETF RateLimit草案的新API
近年不少新API采用IETF draft标准的RateLimit-*命名(无X-前缀),工具同样能正确识别解析
处理429限流响应的重试逻辑设计
解析Retry-After头判断应该等待多少秒后重试,无论服务器返回的是秒数还是HTTP日期格式都能统一转换理解

常见问题

支持哪些限流Header命名约定?
支持四类:GitHub等常用的X-RateLimit-Limit/Remaining/Reset;IETF draft标准的RateLimit-Limit/Remaining/Reset(无X-前缀);OpenAI风格的双维度命名x-ratelimit-limit-requests/remaining-requests/reset-requests(请求数维度)和x-ratelimit-limit-tokens/remaining-tokens/reset-tokens(Token数维度);以及独立的Retry-After头。多种命名约定可以同时出现在同一段粘贴文本中,工具会分别识别展示。
Reset时间是怎么判断格式的?
工具会判断数值大小:如果数值落在合理的Unix时间戳范围内(大约对应2001年到2100年之间的秒级时间戳),就当作时间戳转换成可读日期时间;否则按相对秒数处理,展示为多少秒后重置。这是因为不同API对Reset字段的语义定义不完全一致,有的返回绝对时间戳,有的返回相对倒计时秒数。
为什么OpenAI风格的请求数和Token数会分开展示?
这是近几年AI API常见的双维度限流设计——同一个API Key可能请求数还没用完但Token数已经耗尽(或反过来),两个维度是独立计算独立重置的。工具按x-ratelimit-*-requests和x-ratelimit-*-tokens的后缀区分两个维度,分别计算各自的剩余配额和使用百分比,避免混淆。
粘贴的响应头会被发送到服务器吗?
不会。解析过程完全在浏览器本地完成,不会将你粘贴的任何内容上传到服务器,可以放心粘贴包含内部API信息的响应头文本。