3.5. 调试

设置网关配置很容易，但您可能仍会遇到错误。在这种情况下，网关可以返回有用的调试信息来跟踪错误。

要从 APIcast 获取调试信息，您必须将以下标头添加到 API 请求中： X-3scale-debug: {SERVICE_TOKEN} 使用与您到达的 API 服务对应的服务令牌。

当找到标头且服务令牌有效时，网关会将以下信息添加到响应标头中：

X-3scale-matched-rules: /v1/word/{word}.json, /v1
X-3scale-credentials: app_key=APP_KEY&app_id=APP_ID
X-3scale-usage: usage%5Bversion_1%5D=1&usage%5Bword%5D=1

X-3scale-matched-rules 表示在用逗号分开的列表中为请求匹配了哪些映射规则。

标头 X-3scale-credentials 返回传递给 3scale 后端的凭证。

X-3scale-usage 表示报告给 3scale 后端的使用情况。usage%5Bversion_1%5D=1&usage%5Bword%5D=1 是一个以 URL 编码 的用法[version_1]=1&usage[word]=1，显示 API 请求递增了方法（指标） 版本_1，字 数递增到每个方法。