跳到主要内容

HTTP 状态码

所有 QI Tech API 均按照 RFC 7231 使用以下 HTTP 返回状态标准化:

HTTP 状态含义描述
400Bad Request发送的请求存在格式错误。大多数情况下,我们会在消息正文中返回错误位置的说明。在此 API 中,我们实现了一系列特定错误代码,以帮助理解可能出错的地方。
401Unauthorized身份验证出现问题,请检查 API Key 是否正确以及是否在正确的头部中,详见身份验证部分。
403Forbidden访问的端点仅供内部使用,此 API Key 不可用。
404Not Found使用所提供的密钥未找到请求的数据。当请求无效端点时也会返回此状态。
405Method Not Allowed使用的 HTTP 方法(POST、GET、PUT 等)不适用于所使用的端点。
406Not Acceptable请求正文中发送的数据无效。通常,这意味着发送的数据不是有效的 JSON。
409Conflict发送的文档 ID 对应于之前已处理的 ID。当向服务器发送重复请求,或者两个文档具有相同 ID 的请求时,会返回此状态。
500Internal Server Error处理此请求时出现问题。当此错误发生时,我们的团队会自动收到通知并立即开始分析和解决。
503Service Unavailable您遇到了我们服务器基础设施的计划内或计划外停机。