响应状态码

更新时间不可用

查询弹幕玩法的响应状态码、错误码含义、常见原因和处理建议。

在调用弹幕玩法 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 后,你可以继续查询游戏状态,等待游戏启动。
1103roomid 已被其他用户占用检查主播开播逻辑。
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请求的房间重复开启调用关闭游戏服务关闭该房间后重试。
无服务器内部错误,无法完成请求。重试或联系技术支持。
表格内容超出当前宽度,可横向滚动查看更多列。