响应状态码

更新时间不可用

查询智能云会议的响应状态码、错误码含义、常见原因和处理建议。

在调用智能云会议 RESTful API 过程中,你可能收到如下 HTTP 响应状态码:

  • 如果 HTTP 响应状态码为 200,则请求成功。

  • 如果 HTTP 响应状态码不为 200,则请求失败。根据错误发生在客户端还是服务端,返回结果会有所不同:

    • 如果是客户端错误,HTTP 响应状态码为 40x。
    • 如果是服务端错误,HTTP 响应状态码为 50x。

例如,在客户端和服务端出错时,你可能分别收到如下响应:

JSON
# 404 Not Found
{
  "code": 20404100,
  "msg": "Room not exists!",
  "ts": 1610450153520
}
JSON
# 500 Internal Server Error
{
  "code": 500,
  "msg": "Internal Server Error",
  "ts": 1610167740309
}

下表展示在调用智能云会议 RESTful API 时所有响应状态码、code 字段、含义和建议措施。

状态码code 字段含义建议措施
200 OK0请求成功。无需处理。
400 Bad Request400请求参数错误。检查并修正请求参数。具体信息可参考响应体中的提示内容。
401 UnauthorizedN/A
  • App ID 无效。
  • Authorization 值错误,可能由 x-agora-uid 和 x-agora-token 错误或不匹配导致。
  • 验证并更新 App ID。
  • 验证并更新 Authorization 值。
403 Forbidden30403200会议已禁言,无法发送聊天消息。检查会议状态,解除禁言。
404 Not FoundN/A服务器无法找到请求的资源。确认请求的 URL 是否正确。
404 Not Found20404100会议不存在。检查会议 ID 是否正确。
404 Not Found20404200用户不存在。检查用户 ID 是否正确。
410 Gone30410100会议已结束。确认会议状态,重新开始会议或创建新的会议。
429 Too Many RequestsN/A接口被限流。减少请求频率,稍后重试。
500 Internal Server Error500服务器内部错误,无法完成请求。联系技术支持或管理员,检查服务器日志。
503 Service UnavailableN/A服务器内部错误,充当网关或代理的服务器未从远端服务器获取响应。稍后重试,或联系技术支持检查远端服务器状态。
表格内容超出当前宽度,可横向滚动查看更多列。