查询直播聊天记录
更新时间:2023-07-31
接口描述
获取一场直播的聊天记录
注:只有在直播中的聊天记录才会展示,非直播中的聊天记录不会展示,该接口返回数据中无旁听者信息
请求地址
https://ccapi.csslcloud.net/collect/live/chat/record
请求方式
GET
请求参数
接口统一权限认证请参考THQS认证方式。
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | 开发者账号ID |
roomid | String | 是 | 直播间ID |
liveid | String | 是 | 直播ID |
请求示例
GET https://ccapi.csslcloud.net/collect/live/chat/record?userid=41E8063FC799ACE&roomid=D90DCF5BF6DA3C8C9C33DC5901307461&liveid=A01DD608E39FADC59C33DC5901307461&time=1670412086&hash={hash}
返回数据
公共返回数据结构请参考 公共返回数据说明。
名称 | 类型 | 描述 |
---|---|---|
result | String | 返回状态,"OK":成功,"FAIL":失败 |
roomid | String | 直播间ID |
liveid | String | 直播ID |
data | Array | 聊天数据列表 |
data说明
名称 | 类型 | 描述 |
---|---|---|
id | Integer | 直播聊天记录唯一标识 |
timestamp | String | 聊天记录时间戳,格式:yyyy-MM-dd HH:mm:ss |
username | String | 用户(学员)名称 |
content | String | 聊天内容 |
chat_userid | String | 聊天用户(学员)ID |
userrole | String | 用户角色,presenter为讲师,talker为互动学员,inspector为隐身者,assistant为助教 |
返回示例
{
"roomid": "4C05DAC8965BE2029C33DC5901307461",
"liveid": "2273B106A25921C9",
"result": "OK",
"data":[
{
"id": 123,
"timestamp": "2019-02-18 17:22:50",
"username": "sss",
"content": "sdffs",
"chat_userid": "81d5a1f1bbcb4edb9e1c52e9d75417f4",
"userrole":"presenter"
}
],
"error_msg": ""
}