# 响应状态码 (/zh-CN/api-reference/conversational-ai/rest-api/api/response-code)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

在调用声网对话式 AI 引擎 RESTful API 过程中，你可能收到如下 HTTP 状态码：

- 如果状态码为 `200` 表示请求成功。

- 如果状态码不为 `200`，则请求失败。响应 Body 中包含 `detail` 或 `reason` 字段，用于描述失败的具体原因。

例如，当请求参数异常导致返回 `400` 时，你可能收到如下响应：

```json
{
    "detail": "create agent failed, code: 400, msg: properties: channel not found",
    "reason": "InvalidRequest"
}
```

下面展示请求失败时所有可能的 HTTP 响应状态码、描述和建议措施：

| 响应状态码 | 描述                    | 建议措施                                                     |
| :----- | :---------------------- | :----------------------------------------------------------- |
| 400    | 请求参数异常            | 针对 `detail` 字段提示进行检查。                                |
| 401    | 认证失败                | 如果使用 Token 认证，确认 Token 以 `007` 开头且格式正确；如果使用 Basic Auth，检查 Authorization 请求头和凭证。 |
| 403    | 当前账号不允许使用该服务，或 Token 缺少所需服务权限 | 检查项目是否已开通服务；如果使用 Token 认证，确认 Token 包含 ConvoAI service。                                                     |
| 404    | Agent 未找到或者已经销毁 | 确认任务是否启动成功或者已经退出。                             |
| 409    | Agent 冲突               | 使用服务返回的任务信息继续后续操作，或改用其他智能体名称重试。 |
| 422    | 访问超限                | [联系技术支持](https://ticket.shengwang.cn/)提升配额。                                                 |
| 429    | 请求频率超限            | 使用退避策略重试。                                             |
| 500    | 服务器内部错误          | 如果问题持续存在，请[联系技术支持](https://ticket.shengwang.cn/)。                                                 |
| 502    | 网关异常                | [联系技术支持](https://ticket.shengwang.cn/)。                                                 |
| 503    | Agent 启动错误           | 使用退避策略重试。                                             |
| 504    | 请求超时                | 使用退避策略重试。                                             |

下面展示请求失败时所有可能的 `reason` 值和描述，可结合状态码与 `detail` 字段排查问题：

| `reason`                 | 描述                                                         |
| :------------------------- | :----------------------------------------------------------- |
| `ServiceNotEnabled`         | 当前项目未启用该服务。                                       |
| `AccountSuspended`          | 账号已被停用，无法使用该服务。                               |
| `InternalError`              | 服务端内部错误。                                             |
| `InvalidPermission`          | 未开通服务，或 Token 缺少所需服务权限。         |
| `InvalidRequestBody`         | 请求 Body 不是合法的 JSON。                                      |
| `MissingRequiredField`       | 请求中缺少必填字段。                                         |
| `InvalidFieldValue`          | 请求字段存在非法取值。                                       |
| `ResourceQuotaLimitExceeded` | 并发请求过多，超出配额限制。                                 |
| `ConcurrencyLimitExceeded`   | 并发请求过多，超出配额限制。                                 |
| `ServiceUnavailable`         | 服务暂时不可用。                                             |
| `ResourceAllocationFailed`   | 当前无法分配所需资源，请求暂时无法完成。                     |
| `TaskConflict`               | 已存在同名智能体，或当前已有冲突中的任务在执行。             |
| `TaskNotFound`               | 并未成功启动智能体、或者启动智能体后中途退出、或者已经销毁智能体。 |
| `TaskOperationTimeout`       | 服务端内部错误。                                             |
| `NotImplemented`             | 服务端内部错误。                                             |