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 请求时会出现这种情况。
- no match:这个错误表示请求与任何映射规则不匹配,因此没有更新指标。这不一定是错误,但意味着用户正在尝试随机路径,或者您的映射规则无法涵盖合法情况。
- usage limit exceeded:这个错误表示客户端达到请求的端点的速率限制。如果请求与多个映射规则匹配,客户端可能会达到多个速率限制。
要配置错误,请按照以下步骤执行:
- [Your_product_name] > Integration > Settings 。
- 在 Gateway response 下,选择您要配置的错误类型。
为这些字段指定值:
- 响应代码:三位 HTTP 响应代码。
-
content-type:
Content-Type
标头的值。 - response Body:响应消息正文的值。
- 要保存您的更改,请点击 Update Product。