结束主播连线
收藏接口说明
开发者可结束指定连线 ID 的连线。
使用限制
小玩法 app_id 维度，qps 限流配置为 100 次 /s。
小玩法 app_id +嘉宾 open_id +直播间 room_id 维度，启动和结束玩法 qps 限流配置为 1 次 /s。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://webcast.bytedance.com/api/gaming_con/anchor_linkmic/release |
| HTTP Method | POST |
| Scope | multi_anchor_linkmic |
请求参数
请求头
content-type必填String
示例：application/json
固定值"application/json"
x-token必填String
示例：08011218462b6b4b5054626e426e50685a7554643144644449413d3d
Body
app_idString
玩法ID
link_idInt64
需要结束的连线ID
room_idInt64
房间ID (任意连线了的主播的房间ID),发起结束整场连线的room_id，必填
请求示例
curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/anchor_linkmic/release' \ --header 'X-Token: 08011218474143394b647954536f4b664e63654a727a66355a41xxxx' \ --header 'Content-Type: application/json' \ --data-raw '{"app_id":"ttb101c7bc2e30eexxxx","link_id":740769305443176xxxx,"room_id":742475315370015xxxx}'
响应参数
Body
dataStruct
响应示例
正常响应示例异常响应示例
{ "errcode": 0, "errmsg": "success", }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40001 | 参数错误 | 房间id、小玩法app_id等入参解析失败，检查参数解析逻辑 |
| 200 | 40007 | 请求过于频繁 | 接口有频控限制，建议降低请求的并发量 |
| 200 | 40004 | access_token过期 | 重新生成access_token |
