文档中心 > API类目 > 钉钉API

dingtalk.oapi.live.grouplive.listbytime (查询群直播列表)

根据时间范围查询群直播信息

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
req	GroupLiveRecordReq	必须			查询直播参数
└ end_time Number 必须 1588219442 结束时间，单位秒 └ start_time Number 必须 1587991042 开始时间，单位秒 └ dept_id Number 必须 123 直播所属群对应的部门

响应参数

名称	类型	示例值	描述
errcode	Number	0	错误码
errmsg	String	ok	错误描述
result	GroupLiveListResult []		直播列表
└ duration Number 123 直播时长 └ start_time Number 111111111 直播开始时间 └ title String 直播测试直播标题 └ userid String userid 主播userId └ live_uuid String 53b20173-c0c9-4d35-9dbd-869f2cbb43d8 直播id └ share_from Boolean true true为被联播群，false为主群

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/live/grouplive/listbytime");
OapiLiveGroupliveListbytimeRequest req = new OapiLiveGroupliveListbytimeRequest();
GroupLiveRecordReq obj1 = new GroupLiveRecordReq();
obj1.setEndTime(1588219442L);
obj1.setStartTime(1587991042L);
obj1.setDeptId(123L);
req.setReq(obj1);
OapiLiveGroupliveListbytimeResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

JSON示例

{
    "errcode":0,
    "errmsg":"ok",
    "result":[
        {
                "duration":123,
                "start_time":111111111,
                "title":"直播测试",
                "userid":"userid",
                "live_uuid":"53b20173-c0c9-4d35-9dbd-869f2cbb43d8",
                "share_from":true
        }
    ]
}

异常示例

JSON示例

{
    "errcode":88,
    "errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.live.grouplive.listbytime (查询群直播列表)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ