3.3. 配置错误消息

本节论述了如何配置 APIcast 错误消息。

作为代理,3scale APIcast 使用以下方法管理请求:

  • 如果没有错误,APIcast 会将请求从客户端传递到 API 后端服务器,并将 API 响应返回给客户端,无需修改。如果要修改响应,您可以使用 Header Modification 策略
  • 如果 API 响应错误消息,如 404 Not Found400 Bad Request,APIcast 将返回消息到客户端。但是,如果 APIcast 检测到其他错误,如 身份验证缺失,APIcast 会发送错误消息并终止请求。

因此,您可以将这些错误消息配置为由 APIcast 返回:

  • 身份验证失败:此错误意味着 API 请求不包含有效的凭证,无论是因为伪装凭证,还是因为应用被暂时暂停。另外,这个错误会在指标被禁用时生成,表示其值为 0
  • 缺少身份验证:当 API 请求不包含任何凭证时,会生成此错误。当用户没有将其凭证添加到 API 请求时会出现这种情况。
  • 无匹配项:此错误意味着请求与任何映射规则不匹配,因此没有更新指标。这不一定是错误,但意味着用户正在尝试随机路径,或者您的映射规则无法涵盖合法情况。
  • 超过用量限制:此错误意味着客户端达到所请求端点的速率限值。如果请求与多个映射规则匹配,客户端可能会达到多个速率限制。

要配置错误,请按照以下步骤执行:

  1. [Your_product_name] > Integration > Settings
  2. Gateway response 下,选择您要配置的错误类型。
  3. 为这些字段指定值:

    • 响应代码:HTTP 响应代码。
    • Content-type:Content-Type 标头的值。
    • 响应正文:响应消息正文的值。
  4. 要保存您的更改,请点击 Update Product