UD5工具箱
快速开始：模拟模式测试
第一步，打开速率限制头测试器页面。在页面顶部的模式选择区域，选择"模拟模式"。模拟模式会关闭所有网络请求，所有行为都在本地模拟。第二步，配置速率限制参数。设置窗口大小为60秒，窗口内最大请求数为10，这意味着每60秒内最多允许10个请求。模拟延迟设置为0毫秒（无延迟），429触发阈值设置为100（即达到100%时触发429）。第三步，点击"开始测试"按钮。工具会按照配置的参数依次发送请求，并在下方的监控面板中实时显示结果。您可以观察到前10个请求返回200状态码，第11个请求开始返回429状态码，同时响应头中包含RateLimit-Remaining和RateLimit-Reset等信息。第四步，等待窗口重置。当倒计时归零后，您可以再次点击"开始测试"验证窗口重置行为。
真实请求模式测试
在真实请求模式下，工具会向您指定的目标URL发送实际的HTTP请求。首先，在"目标URL"输入框中输入您要测试的API端点地址，例如"https://api.example.com/v1/users"。然后，选择HTTP方法（如GET）。如果需要认证，在自定义请求头中添加"Authorization: Bearer your_token_here"。设置总请求数为20，并发数为1，批次间隔为500毫秒。点击"开始测试"后，工具会依次发送请求并记录响应。在请求日志中，您可以查看每个请求的状态码和响应头。如果目标API实施了速率限制，您会看到在达到限制后返回429状态码和对应的Retry-After头。将鼠标悬停在响应头表格中的每个头名称上，可以看到该头的详细说明和标准参考。
使用预设方案快速测试
预设方案可以帮助您快速切换不同的测试场景。点击"温和模式"按钮，工具会自动将参数设置为：总请求数10、并发数1、批次间隔200毫秒。这种模式适合测试API的正常限流行为。点击"压力模式"按钮，参数变为：总请求数100、并发数10、批次间隔10毫秒。高并发场景下，服务器可能在短时间内返回大量429响应。点击"突发模式"按钮，参数变为：总请求数50、并发数50、批次间隔0毫秒。所有请求几乎同时发出，模拟瞬间流量激增的场景。点击"恢复模式"按钮，参数变为：总请求数20、并发数1、批次间隔1000毫秒。每秒发送一个请求，适合观察限流窗口的恢复过程。您可以选择预设后，再手动微调参数以适应具体需求。
自定义请求头与请求体
对于需要认证或特殊头部的API，您需要配置自定义请求头。在"自定义请求头"区域，点击"添加请求头"按钮，输入头部名称和值。例如，要测试GitHub API的速率限制，您可以添加"Authorization: ghp_xxxxxxxxxxxx"头。对于POST请求，您可以在"请求体"编辑器中输入JSON格式的数据。工具提供了语法高亮和自动缩进功能，方便编辑JSON内容。请注意，请求体必须是合法的JSON格式，否则工具会提示格式错误。添加完成后，点击"更新请求头"按钮保存配置。这些自定义头部和请求体会在后续所有请求中自动携带。
分析响应头与速率限制信息
测试完成后，重点关注"最近速率限制响应头"面板。该面板以表格形式展示最近一次响应中的所有速率限制相关头部。表格包含三列：Header Name（头部名称）、Value（值）和CORS（是否为CORS相关头部）。工具会自动识别标准头部（如RateLimit-Limit）和自定义头部（如X-RateLimit-Limit），并标注其含义。如果服务器返回了Retry-After头，工具会额外显示建议的等待时间。将鼠标悬停在头部名称上，可以看到该头部的详细说明和RFC标准参考。如果响应中没有包含任何速率限制头部，工具会提示"No rate limit headers detected"，说明目标API可能没有实施速率限制，或者使用了非标准的方式（如基于IP的限流）。
导出测试数据
当您需要对测试结果进行深入分析或存档时，可以使用CSV导出功能。在请求日志面板中，点击"导出CSV"按钮。工具会将所有请求的信息（包括序号、时间戳、HTTP方法、URL、状态码、响应时间、请求头摘要、响应头摘要）导出为CSV文件。下载的文件可以直接在Excel或Google Sheets中打开。您可以使用Excel的数据透视表功能按状态码分组统计，计算成功率和平均响应时间。也可以使用图表功能绘制请求时间线和响应时间分布图。导出的CSV文件还方便与团队成员共享，用于问题排查和技术评审。
高级场景：验证指数退避算法
如果您正在开发API客户端，需要验证指数退避算法的正确性，可以按照以下步骤操作。首先，在模拟模式下将速率限制参数设置为：窗口大小30秒、最大请求数5、429触发阈值100。将总请求数设置为20，并发数为1，批次间隔为0（由客户端逻辑控制等待时间）。点击"开始测试"。当收到429响应时，根据Retry-After头的值等待对应时间，然后重试。观察每次重试是否按照2的幂次递增等待时间（如1秒、2秒、4秒、8秒）。同时关注"速率限制窗口状态"面板，确认在窗口重置后请求能正常通过。这种测试方式可以帮助您在不实际调用第三方API的情况下验证重试逻辑的健壮性。