在不消耗每日配额的情况下测试您的集成

构建一个集成，通常意味着在接触生产流量之前要进行几十甚至几百次测试调用，而这些测试都不需要用到付费套餐。

任何地址每天都可获得 2,500 次免费请求，完全不需要密钥，这足以满足大多数集成工作：搭建请求格式、检查响应解析，以及为每种情况用少量测试用例完成错误处理。

GET /v1/forward?q=Test Address, Test City&limit=1

不需要 X-API-Key 请求头，不需要 Authorization 请求头，只需要请求本身。

即使没有密钥，每个响应也都带有相同的配额响应头，因此您可以看到 X-Quota-Used 和 X-Quota-Free-Remaining 的升降与生产环境中完全一样，这有助于在真正关键之前测试您自己的代码如何处理这些响应头。

X-Quota-Limit: 2500
X-Quota-Used: 42
X-Quota-Free-Remaining: 2458

注册并生成密钥后，该密钥还会另外获得每天 2,500 次免费请求，这是一个独立的测试空间，不会动用预付额度，也不计入 Unlimited 套餐。此时正适合测试与密钥相关的行为，例如发送密钥的不同方式（请求头、Bearer 令牌、Basic 认证或查询参数），全程无需任何花费。

发送一个带有无效参数的请求来查看 400，或故意使用错误的密钥来查看 401，这样您的错误处理代码在上线前就经过了实际检验，而不是想当然地认为它能正常工作。这些测试调用无论成功与否，每次都只占用免费配额中的一次请求，在正常的测试量下无需为此担心。

真实流量开始后，同样的免费配额仍能覆盖许多小型集成的日常用量，只有当用量超过每天 2,500 次请求时，才需要预付额度或 Unlimited 套餐。

这里不需要单独的沙盒环境，因为免费配额已经提供了使用真实 API 的完整测试场地。您可以从控制台生成密钥开始，如果想在注册前先了解密钥格式，也可以先阅读身份验证文档。

更多指南