响应状态码

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

例如，当请求参数异常导致返回 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	访问超限	联系技术支持提升配额。
429	请求频率超限	使用退避策略重试。
500	服务器内部错误	如果问题持续存在，请联系技术支持。
502	网关异常	联系技术支持。
503	Agent 启动错误	使用退避策略重试。
504	请求超时	使用退避策略重试。

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

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

咨询电话