响应状态码

在调用灵动会议 RESTful API 过程中，你可能收到如下 HTTP 响应状态码：

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

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

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

  你可以根据响应 Body 中的 code 字段排查问题。

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

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 OK	0	请求成功。	无需处理。
400 Bad Request	400	请求参数错误。	检查并修正请求参数。具体信息可参考响应体中的提示内容。
401 Unauthorized	N/A	App ID 无效。 Authorization 值错误，可能由 x-agora-uid 和 x-agora-token 错误或不匹配导致。	验证并更新 App ID。 验证并更新 Authorization 值。
403 Forbidden	30403200	会议已禁言，无法发送聊天消息。	检查会议状态，解除禁言。
404 Not Found	N/A	服务器无法找到请求的资源。	确认请求的 URL 是否正确。
404 Not Found	20404100	会议不存在。	检查会议 ID 是否正确。
404 Not Found	20404200	用户不存在。	检查用户 ID 是否正确。
410 Gone	30410100	会议已结束。	确认会议状态，重新开始会议或创建新的会议。
429 Too Many Requests	N/A	接口被限流。	减少请求频率，稍后重试。
500 Internal Server Error	500	服务器内部错误，无法完成请求。	联系技术支持或管理员，检查服务器日志。
503 Service Unavailable	N/A	服务器内部错误，充当网关或代理的服务器未从远端服务器获取响应。	稍后重试，或联系技术支持检查远端服务器状态。