查询主播连麦信息
收藏接口说明
可获取主播连线麦位信息，获取在麦位上用户的open_id
使用限制
小玩法app_id维度，限流配置为 200/s。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://webcast.bytedance.com/api/gaming_con/anchor_linkmic/query |
| HTTP Method | POST |
| Scope | multi_anchor_linkmic |
请求参数
请求头
content-type必填String
示例：application/json
固定值"application/json"
x-token必填String
示例：08011218462b6b4b5054626e426e50685a7554643144644449413d3d
Body
app_idString
玩法APPID，必填
link_idInt64
主主连线ID，必填
room_idInt64
发起查询的房间ID，必填
请求示例
curl --location --request POST 'https://webcast.bytedance.com/api/gaming_con/anchor_linkmic/prepare' \ --header 'X-Token: 08011218474169395a305953426c41386e514d4d362b38627767xxxx' \ --header 'Content-Type: application/json' \ --data-raw '{"room_id":743820458384064xxxx,"app_id":"ttb101c7bc2e30eexxxx"}'
响应参数
Body展开全部子属性
dataStruct
展开子属性
errcodeInt64
错误码，0代表成功
errmsgString
错误描述
响应示例
{ "errcode": 193537733123330050, "errmsg": "5thTSouPT3", "data": { "rooms": [ { "room_id_str": "5bKc953Z8b", "room_id": 3076761937705790500, "linked_audience_list": [ { "open_id": "55ZIN0Wuoo", "avatar_url": "xGIOcNd6qY", "nick_name": "W1rEDXAuxR" } ], "anchor": { "nick_name": "P7WKWAryeK", "open_id": "49lCZKpIst", "avatar_url": "Zvnty1i4tO" } } ] } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40001 | 参数错误 | 请求体中的必传参数是否都上传、请求的小玩法app_id是否与请求时access_token相匹配 |
| 200 | 40007 | 请求过于频繁 | 接口有频控限制，建议降低请求的并发量 |
| 200 | 40004 | access_token过期 | 重新生成access_token |
| 200 | 50034 | 未开启聊天室 | 开启聊天室 |
