中途单主播离线
收藏接口说明
开发者可指定某个主播中途离开主播连线，若该主播直播间存在其他参与主播连线的其他嘉宾，则其他嘉宾会一同离开主播连线。
使用限制
小玩法 app_id 维度，qps 限流配置为 200 次 /s。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://webcast.bytedance.com/api/gaming_con/anchor_linkmic/anchor_leave |
| 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，必填
请求示例
curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/anchor_linkmic/anchor_leave' \ --header 'X-Token: 08011218462f32614a5749694563723467426974475079632f41xxxx' \ --header 'Content-Type: application/json' \ --data-raw '{"app_id":"ttb101c7bc2e30eexxxx","link_id":742471707923830xxxx,"room_id":742475315370015xxxx}'
响应参数
Body
dataStruct
响应示例
正常响应示例异常响应示例
{ "errcode": 0, "errmsg": "success", }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40001 | 参数错误 | 房间id、小玩法app_id等入参解析失败，检查参数解析逻辑 |
| 200 | 40007 | 请求过于频繁 | 接口有频控限制，建议降低请求的并发量 |
| 200 | 40004 | access_token过期 | 重新生成access_token |
| 200 | 50047 | 当前用户不在连麦中 | 当前传入的用户已经不在连麦中 |
