创建直播

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，创建直播。

接口调用流程

步骤一：调用本接口，获取直播ID。

步骤二：使用直播ID，拼接以下链接： dingtalk://dingtalkclient/action/start_uniform_live?liveUuid=直播ID

步骤三：员工访问该链接，可创建直播，实现效果如下图所示。

说明

调用本接口创建的直播ID只能创建一次直播，重复使用直播ID创建直播会出现报错。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	钉钉直播获取数据写权限	API Explorer
第三方企业应用	支持	钉钉直播获取数据写权限	API Explorer
第三方个人应用	暂不支持	钉钉直播获取数据写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidParam	lippi_live.stream.paramError	参数错误，预计开播时间必须是未来时间并且小于预计结束时间。
400	contentNotCompliant	lippi_live.validate.contentNotCompliant	内容不合规
400	noPermission	lippi_live.stream.noPermission	鉴权失败，请检查publicType字段是否为全域公开,若全域公开需要升级直播权益；
500	serviceError	error:%s	系统服务错误

curl --location --request POST 'https://api.dingtalk.com/v1.0/live/lives' \ --header 'Content-Type: application/json' \ --data-raw '{ "unionId" : "String", "title" : "String", "introduction" : "String", "coverUrl" : "String", "preStartTime" : Long, "preEndTime" : Long }'

接口调用流程

权限

错误码

请求参数

返回响应

创建直播

接口调用流程#

权限#

错误码#

请求参数

返回响应

接口调用流程

权限

错误码