请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/living/modify?access_token=ACCESS_TOKEN
请求包体:
{
"livingid": "XXXXXXXXX",
"theme": "theme",
"living_start": 1600100000,
"living_duration": 3600,
"description": "test description",
"type": 1,
"remind_time": 60
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证。获取方法查看“获取access_token” |
livingid | 是 | 直播id,仅允许修改预约状态下的直播id |
theme | 否 | 直播的标题,最多支持60个字节 |
living_start | 否 | 直播开始时间的unix时间戳 |
living_duration | 否 | 直播持续时长 |
type | 否 | 直播的类型,0:通用直播,1:小班课,2:大班课,3:企业培训,4:活动直播。其中大班课和小班课仅k12学校和IT行业类型能够发起 |
description | 否 | 直播的简介,最多支持300个字节 |
remind_time | 否 | 指定直播开始前多久提醒用户,相对于living_start前的秒数,默认为0 |
权限说明:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「上课直播/直播 - 可调用接口的应用」中 |
代开发应用 | 具有「直播」权限 |
第三方应用 | 具有「直播」权限 |
返回结果:
{
"errcode": 0,
"errmsg": "ok"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |