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