第三方应用开发 服务端API 家校应用 上课直播 获取老师直播ID列表
获取老师直播ID列表
最后更新:2023/12/08
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取老师直播ID列表
最后更新:2023/12/08

通过此接口可以获取指定老师的所有直播ID

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/living/get_user_all_livingid?access_token=ACCESS_TOKEN

请求包体:

{
	"userid": "USERID",
	"cursor": "NEXT_KEY",
	"limit": 20
}

参数说明:

参数必须说明
access_token调用接口凭证
userid企业成员的userid
cursor上一次调用时返回的next_cursor,第一次拉取可以不填
limit每次拉取的数据量,默认值和最大值都为100

权限说明:

应用类型权限要求
自建应用配置到「上课直播/直播 - 可调用接口的应用」中
代开发应用具有「上课直播/直播」权限
第三方应用具有「上课直播/直播」权限
  • 只能获取本应用创建的直播

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "next_cursor": "next_cursor",
   "livingid_list":[
		"livingid1",
		"livingid2"
   ]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
next_cursor当前数据最后一个key值,如果下次调用带上该值则从该key值往后拉,用于实现分页拉取,返回空字符串代表已经是最后一页
livingid_list直播ID列表
上一篇
家校通讯录批量变更事件
下一篇
获取直播详情