3.3. 配置错误消息
本节论述了如何配置 APIcast 错误消息。
作为代理,3scale APIcast 使用以下方法管理请求:
- 如果没有错误,APIcast 会将请求从客户端传递到 API 后端服务器,并将 API 响应返回给客户端,无需修改。如果要修改响应,您可以使用 Header Modification 策略。
-
如果 API 响应错误消息,如
404 Not Found
或400 Bad Request
,APIcast 将返回消息到客户端。但是,如果 APIcast 检测到其他错误,如身份验证缺失
,APIcast 会发送错误消息并终止请求。
因此,您可以将这些错误消息配置为由 APIcast 返回:
-
身份验证失败:此错误意味着 API 请求不包含有效的凭证,无论是因为伪装凭证,还是因为应用被暂时暂停。另外,这个错误会在指标被禁用时生成,表示其值为
0
。 - 缺少身份验证:当 API 请求不包含任何凭证时,会生成此错误。当用户没有将其凭证添加到 API 请求时会出现这种情况。
- 无匹配项:此错误意味着请求与任何映射规则不匹配,因此没有更新指标。这不一定是错误,但意味着用户正在尝试随机路径,或者您的映射规则无法涵盖合法情况。
- 超过用量限制:此错误意味着客户端达到所请求端点的速率限值。如果请求与多个映射规则匹配,客户端可能会达到多个速率限制。
要配置错误,请按照以下步骤执行:
- [Your_product_name] > Integration > Settings 。
- 在 Gateway response 下,选择您要配置的错误类型。
为这些字段指定值:
- 响应代码:HTTP 响应代码。
-
Content-type:
Content-Type
标头的值。 - 响应正文:响应消息正文的值。
- 要保存您的更改,请点击 Update Product。