操作步骤
| 步骤 | 操作 | 详细说明 |
|---|---|---|
| 1 | 获取响应头 | 使用 curl -v 或其他工具发起 API 请求,获取完整的 HTTP 响应头。例如:curl -v https://api.github.com/users/octocat 会输出包含 RateLimit 字段的响应头信息。 |
| 2 | 粘贴响应头 | 将复制的响应头文本粘贴到工具上方的“粘贴 HTTP 响应头”输入框中。支持多行文本输入,会自动过滤非相关行。 |
| 3 | 自动解析 | 工具会自动识别响应头中的速率限制相关字段,包括 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset、X-RateLimit-Used、Retry-After 等,并在仪表盘和详情表中展示解析结果。 |
| 4 | 查看仪表盘 | 在仪表盘区域查看使用率进度条、已使用量、剩余量、使用率百分比、窗口重置倒计时和 Retry-After 等待时信息。绿色表示安全,黄色表示警告,红色表示已达上限。 |
| 5 | 复制报告 | 点击解析详情区域的“复制报告”按钮,将完整的解析结果以文本格式复制到剪贴板,方便粘贴到文档或发送给团队成员。 |
| 6 | 使用预设场景 | 如果没有实际响应头,可以点击预设按钮(GitHub 正常、GitHub 告警、OpenAI、已耗尽、429 重试)快速体验工具功能。每个预设都模拟了真实的 API 响应场景。 |
| 7 | 清空重置 | 点击清空按钮可清除所有已输入的内容和解析结果,将仪表盘和详情表恢复到初始状态,方便进行下一次解析操作。 |
使用技巧
curl -v 命令
使用 curl -v 发起请求可以获取包括响应头在内的完整 HTTP 信息。响应头以 > 开头,请求头以 > 开头。
注意字段命名
不同平台的字段命名可能不同,例如 Twitter 使用小写 x-rate-limit-,而 GitHub 使用 X-RateLimit-。本工具都能自动识别。
关于重置时间戳
X-RateLimit-Reset 通常是 Unix 时间戳(从 1970 年 1 月 1 日起的秒数),也有少数 API 使用相对秒数。本工具会自动识别并转换为可读的日期时间格式。
常见问题解决
没有识别到字段
如果工具未能识别您的响应头,可能是因为字段命名不符合常见规范。可以尝试使用手动编辑模式直接输入各项值,然后点击应用手动输入进行分析。
重置时间不准确
某些 API 的 Reset 字段使用相对秒数而非 Unix 时间戳,本工具会尝试自动识别。如果显示的重置时间有误,可以手动输入正确的 Unix 时间戳到重置时间戳字段中。
UD5工具箱