响应状态码
更新时间不可用
查询 RTC 频道管理 RESTful API 的响应状态码含义、常见原因和处理建议。
本文介绍调用 RTC 频道管理 RESTful API 返回的所有响应状态码。
-
如果状态码为
200，则请求成功。 -
如果状态码不为
200，则请求失败。你可以根据对应的响应体中可能出现的message以及reason字段排查问题
例如，请求失败时，你可能收到如下响应：
{
"message": "invalid appid"
}响应状态码
下表展示使用 RTC 频道管理 RESTful API 发起请求时，你可能会收到的所有响应状态码、对应的含义以及建议措施：
| 状态码 | 含义 | 建议措施 |
|---|---|---|
200 OK | 操作成功。 | 无需排查。 |
400 Bad Request | 请求无效。 | 结合响应 Body 中的 message 字段进一步排查。 |
401 Unauthorized | 未经授权。 | 检查并确认你的认证信息是否正确。可能的原因包括：
|
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，然后重新创建封禁用户权限规则。