API 返回码
公共返回码
| 返回码 | 说明 | 处理建议 |
|---|---|---|
| 0 | 成功 | - |
| 100000000 | 请求头部中的 Host 错误。 | 请确认请求头部 Host 地址是否正确。 |
| 100000001 | AppId 字段格式错误。 | 请填写正确的 AppId。 |
| 100000002 | Timestamp 字段为空。 | 请填写 Timestamp。 |
| 100000003 | Timestamp 字段格式错误。 | 请填写正确 Unix 时间戳（单位秒）。 |
| 100000004 | 签名过期。 | 请重新生成签名。 |
| 100000005 | 签名错误。 | 请确认生成签名的参数是否正确。 |
| 100000006 | Action 为空。 | 请指定 Action。 |
| 100000007 | 不支持的 Action。 | 请填写正确的 Action。 |
| 100000008 | SignatureNonce 字段为空。 | 请填写 SignatureNonce。 |
| 100000009 | Signature 字段为空。 | 请填写 Signature。 |
| 100000010 | 获取 ServerSecret 失败。 | 请确认 AppId 是否正确。 |
| 100000011 | 获取 App 配置失败。 | 请确认 AppId 是否正确，或联系 ZEGO 技术支持处理。 |
| 100000012 | 读取 HTTP 包体失败。 | 请联系 ZEGO 技术支持处理。 |
| 100000013 | SignatureVersion 字段为空。 | 请填写 SignatureVersion。 |
| 100000014 | 不支持的 SignatureVersion。 | SignatureVersion 仅支持 2.0。 |
| 100000015 | 网关内部错误。 | 请联系 ZEGO 技术支持处理。 |
| 100000017 | App 未开通该服务。 | 请联系 ZEGO 技术支持处理。 |
业务返回码
| 返回码 | 说明 | 处理建议 |
|---|---|---|
| 410000001 | 系统错误。 | 请联系 ZEGO 技术支持处理。 |
| 410000002 | AppID 无效。 | 请检查 AppID 是否正确。 |
| 410000003 | 参数无效。 | 请依据 Message 提示，检查不合法的输入参数。 |
| 410000004 | JSON 解析失败 | 请检查请求参数是否是合法的 JSON。 |
| 410000005 | 网关鉴权失败。 | 请联系 ZEGO 技术支持处理。 |
| 410000006 | App 未开通该服务。 | 请联系 ZEGO 技术支持处理。 |
| 410000009 | 服务内部调用失败。 | 请联系 ZEGO 技术支持处理。 |
| 410000010 | 服务资源不足。 | 请联系 ZEGO 技术支持处理。 |
| 410001002 | 未找到智能体实例。 | 请检查智能体实例是否已被删除。 |
| 410001003 | 智能体实例创建失败。 | 请联系 ZEGO 技术支持处理。 |
| 410001004 | 智能体实例修改失败。 | 请联系 ZEGO 技术支持处理。 |
| 410001005 | 智能体实例删除失败。 | 请联系 ZEGO 技术支持处理。 |
| 410001006 | 主动调用 LLM 失败。 | 请联系 ZEGO 技术支持处理。 |
| 410001007 | 主动调用 TTS 失败。 | 请联系 ZEGO 技术支持处理。 |
| 410001008 | 智能体已存在。 | 请勿重复创建 |
| 410001009 | 智能体未找到。 | 请检查是否已创建该智能体。 |
| 410001010 | 加载历史消息失败。 | 请联系 ZEGO 技术支持处理。 |
| 410001011 | 智能体实例更新失败。 | 请联系 ZEGO 技术支持处理。 |
| 410001013 | 智能体正在聆听。 | 智能体处于聆听状态时，不支持主动调用 LLM 或 TTS。 |