响应状态码

在调用弹幕玩法 RESTful API 过程中，你可能收到如下 HTTP 状态码：

• 如果状态码为 200 且响应包体中的 err_no 为 0 表示请求成功。

• 如果状态码不为 200 或状态码为 200 但响应包体中的 err_no 不为 0 则请求失败。响应包体中包含 err_no 和 err_msg 字段，描述失败具体原因。

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

JSON

## 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	请求的房间重复开启	调用关闭游戏服务关闭该房间后重试。
无	服务器内部错误，无法完成请求。	重试或联系技术支持。