批量查询指定直播间列表信息 · 小鹅云文档

# 批量查询指定直播间列表信息 |拥有此API的权限集| |:----- | |直播管理-查询直播信息| **请求方式及url** - 请求方式： `POST` - 请求头：`Content-Type:application/json` - 接口地址： `https://api.xiaoe-tech.com/xe.alive.list.by_ids/1.0.0` - 频率限制：`10秒100次` {% api method="POST", data={ "access_token" : "xe_xxxxx", "ids":[ "l_6448e06ce4b0cf39e6c1xxxx", "l_6448e056e4b0cf39e6c1xxxx" ] }, url="https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/xe.alive.list.by_ids/1.0.0" %} {% endapi %} **请求参数** |参数名|必选|类型|说明|备注（示例） |:---- |:---|:----- |:----- |----| |access_token |是 |string | [专属token](./../get_access_token.md) |`...`| |ids |是 |array | 直播 id 列表，限制最大为50 |`...`| **请求示例** ``` { "access_token" : "xe_xxxxx", "ids":[ "l_6448e06ce4b0cf39e6c1xxxx", "l_6448e056e4b0cf39e6c1xxxx" ] } ``` **返回参数说明** |参数名|必选|类型|说明|备注（示例） |:---- |:---|:----- |:----- |----| |code |是 |int | 错误码 |`0`| |msg |是 |string | 错误描述 |`ok`| |data |是 |Object | 返回值 |`...`| |data.total | 是 | int | 查询结果记录数 | `...` | |data.page | 是 | int | 当前页码 | `...` | |data.page_count | 是 | int | 总页数 | `...` | |data.list | 是 | Array | 直播信息列表 | `...` | 直播信息列表`list` |参数名|必选|类型|说明|备注（示例） |:---- |:---|:----- |:----- |----| |id |是 |string | 直播id |`...`| |alive_manual_stop_at |是 |string | 直播手动结束时间 |`...`| |alive_stop_at |是 |string | 直播结束时间 |`...`| |title |是 |string | 直播名称 |`...`| |view_count |是 |int | 直播观看人次，每5分钟同步一次数据 |`...`| |alive_type |是 |int | 直播类型,10 横屏直播；11竖屏直播；12语音直播；13录播直播 |`...`| |reward_sum | 是 | string |打赏金额（元） | `...` | |recycle_bin_state | 是 | int |直播商品状态：-1 全部； 0 已上架； 1 已下架；2 待上架| `...` | |alive_start_at | 是 | string |直播开始时间 | `...` | |alive_state | 是 | int |直播状态：-1全部；0未开始；1直播中；2已结束| `1` | |live_state | 是 | int |直播间状态：0未开始；1直播中；2互动时间（仅录播有，直播视频推流完成并且在预设开播时间范围内）；3已结束、4讲师暂时离开（直播范围时间内未推流或断流后5分钟）| `1` | |resource_state| 是 | int |直播显隐状态：0-显示，1-隐藏| `1` | |page_url | 是 | string |直播地址| `...` | |create_mode | 是 | int |直播课程类型：-1 全部；0 店铺课程； 1 转播课程| `...` | |img_url | 是 | string |封面地址| `...` | |alive_img_url| 是 | string |直播宣传图地址| `...` | 讲师列表信息`list` |参数名|类型|说明| |:---- |:---|:----- |:----- | |user_id |string | 讲师id | |user_name |string | 讲师昵称 | |phone |int | 讲师绑定手机号 | **返回示例** ``` { "code": 0, "msg": "ok", "data": { "list": [ { "alive_manual_stop_at": "", "alive_start_at": "2021-12-31 15:59:59", "alive_state": 1, "alive_stop_at": "2031-12-29 15:59:59", "alive_type": 10, "create_mode": 0, "guest_list": [ { "phone": "", "user_id": "u_61a88d4ab6d3e_pHRHoxxxxx", "user_name": "白菜豆腐鱼*" } ], "id": "l_61ceb76ee4b0a91144bxxxxx", "img_url": "https://wechatapppro-12525xxxxx.file.myqcloud.com/appAKLWLixxxxxx/image/b_u_5b2225aa46488_oGKN7IvA/kxtzxnxxxxxx.jpeg", "page_url": "https://appAKLWLxxxxx.h5.xiaoeknow.com/content_page/eyJ0eXBlIjoiMiIsInJlc291cmNlX3R5cGUiOjQsInJlc291cmNlX2lkIjoibF82MWNlYjc2ZWU0YjBhOTExNDRiMDg0MjQiLCJhcHBfaWQiOiJhcHBBS0xXTGl0bjc5NzgiLCJwcm9kdWN0Xxxxxxxx", "recycle_bin_state": 0, "reward_sum": "0.00", "title": "Rock-测试看看（横屏直播）-网页端直播2", "view_count": 6 } ], "page": 1, "page_count": 22949, "total": 22949 } } ```