响应状态码
更新时间不可用
查询弹幕玩法的响应状态码、错误码含义、常见原因和处理建议。
在调用弹幕玩法 RESTful API 过程中,你可能收到如下 HTTP 状态码:
-
如果状态码为
200且响应包体中的err_no为0表示请求成功。 -
如果状态码不为
200或状态码为200但响应包体中的err_no不为0则请求失败。响应包体中包含err_no和err_msg字段,描述失败具体原因。
例如,请求失败时,你可能收到如下响应:
## 200 OK
{
"err_no": 1002,
"err_msg": "invalid parameter",
"requestId": "iUxxxXS_gGxxxXWw",
}下面展示请求失败时所有可能的 HTTP 响应状态码和处理建议:
- 状态码为
500 Internal Server Error,代表服务器内部错误,无法完成请求。建议重试或联系技术支持。 - 状态码为
200 OK,可能的err_no字段、说明、建议处理方式详见下表:
err_no | 说明 | 处理建议 |
|---|---|---|
| 0 | 请求成功 | 无需处理。 |
| 1002 | 无效的参数 | 检查请求参数。 |
| 1003 | 游戏服务异常 | 联系声网技术支持。 |
| 1004 | 数据库错误 | 联系声网技术支持。 |
| 1101 | 正在分配游戏资源 | HTTP Response header 会附带正在调度的 task_id,HTTP Response header 的名字是 x-task-id。拿到这个 task_id 后,你可以继续查询游戏状态,等待游戏启动。 |
| 1103 | roomid 已被其他用户占用 | 检查主播开播逻辑。 |
| 1104 | 错误的游戏 ID | 检查游戏 ID 是否正确。 |
| 1106 | 弹幕玩法服务内部错误 | 重试。 |
| 2002 | 当前没有可用的云主机资源 | 排队等待。 |
| 2003 | 项目所属 APP ID 未开通弹幕玩法 | 联系销售开通弹幕玩法。 |
| 2004 | 游戏 ID 未授权 | 联系销售开通对应游戏。 |
| 2005 | 更新 Token 失败 | 重试。 |
| 10001 | 弹幕玩法服务内部错误 | 重试。 |
| 10004 | 对应房间任务不存在 | 检查 roomid 是否正确。 |
| 40001 | 参数不合法 | 检查请求参数格式。 |
| 40023 | 参数缺失 | 参考文档补其必传的参数。 |
| 92000 | 游戏方接收消息未启动 | 先启动游戏。 |
| 92001 | 向游戏端推送消息失败,但写入重试队列成功 | 可以重试,或者不做处理,游戏端会定时轮询重试队列做消息补偿。 |
| 92002 | 向游戏端推送消息失败,且写入重试队列失败 | 重试。 |
| 92003 | 发送的游戏指令不匹配 | 检查游戏指令并重试。 |
| 92004 | 发送的礼物 ID 不匹配 | 检查礼物 ID 并重试。 |
| 92005 | 发送的礼物金额不匹配 | 检查礼物金额并重试。 |
| 93001 | 请求的房间重复开启 | 调用关闭游戏服务关闭该房间后重试。 |
| 无 | 服务器内部错误,无法完成请求。 | 重试或联系技术支持。 |