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: /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 请求递增了每个方法(metrics) version_1 和 字。