响应状态码

本文介绍调用 RTC 频道管理 RESTful API 返回的所有响应状态码。

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

• 如果状态码不为 200，则请求失败。你可以根据对应的响应体中可能出现的 message 以及 reason 字段排查问题

例如，请求失败时，你可能收到如下响应：

JSON

# 400 Bad Request
{
  "message": invalid appid"
}

响应状态码

下表展示使用 RTC 频道管理 RESTful API 发起请求时，你可能会收到的所有响应状态码、对应的含义以及建议措施：

状态码	含义	建议措施
200 OK	操作成功。	无需排查。
400 Bad Request	请求无效。	结合响应 Body 中的 message 字段进一步排查。
401 Unauthorized	未经授权。	检查并确认你的认证信息是否正确。可能的原因包括： App ID 不存在。 客户 ID 和客户密钥不匹配。
403 Forbidden	禁止访问。	授权信息错误，联系技术支持。
404 Not Found	请求的资源未找到。	确认请求的 URL 和资源是否正确。
415 Unsupported Media Type	不支持的媒体类型。	检查并确保请求头中的 Content-Type 设置为 application/json。
429 Too Many Requests	请求过于频繁。	等待一段时间后再重试。
500 Internal Server Error	服务器内部错误。	使用退避策略进行查询请求或联系技术支持。

信息

如果根据表格中的排查措施并未解决问题，请务必在日志中打印出响应头中的 X-Request-ID 和 X-Resource-ID 字段值，并联系技术支持。

以下是一个排查问题的示例：

使用 RTC 频道管理 RESTful API 创建封禁用户权限规则时，如果响应状态码为 400 Bad Request，message 为 "invalid appid"，则表示 App ID 无效，本次创建规则失败。请进入声网控制台重新获取 App ID，然后重新创建封禁用户权限规则。