所有的 API 请求只要到达了网关,网关就会返回请求结果信息。
用户需要查看返回结果的头部,即 Header 部分。其中 X-Ca开头的均为网关返回,比较重要信息是:
// 请求唯一ID,请求一旦进入API网关应用后,API网关就会生成请求ID并通过响应头返回给客户端,建议客户端与后端服务都记录此请求ID,可用于问题排查与跟踪
X-Ca-Request-Id: 7AD052CB-EE8B-4DFD-BBAF-EFB340E0A5AF
// API网关返回的错误消息,当请求出现错误时API网关会通过响应头将错误消息返回给客户端
X-Ca-Error-Message: Invalid Parameter Required `field1`
// API网关系统错误码,当请求出现错误被网关拦截后,由API网关提供的错误码
X-Ca-Error-Code: I400MP
在应答的Header
中获得X-Ca-Error-Code
与X-Ca-Error-Message
可以基本明确报错原因,而X-Ca-Request-Id
可以用于在日志服务中查询请求日志、通过控制台查询结果、或提供给支持人员进行日志排查。
X-Ca-Error-Code
可以查找错误代码表来获取更详细的排错解释。