获取直播间讨论区消息列表2.0
| 拥有此API的权限集 |
|---|
| 直播管理-查询 |
请求方式及url
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
https://api.xiaoe-tech.com/xe.alive.msg_list.get/2.0.0 - 频率限制：
10秒100次
在线调试工具
请求
响应
请求参数
| 参数名 | 必选 | 类型 | 说明 | 备注（示例） |
|---|---|---|---|---|
| access_token | 是 | string | 专属token | ... |
| alive_id | 是 | string | 直播的资源id | ... |
| comment_id | 否 | string | 评论id，用于分页，从第二页起，此参数值传上一页数据的最后一个comment_id | ... |
| size | 否 | int | 条数，最大50条，不传则默认50 | ... |
| user_id | 否 | string | 用户id | ... |
请求示例
{
"access_token" : "xe_xxxxx",
"alive_id": "l_xxx",
"size": 50
}
返回参数说明
| 参数名 | 必选 | 类型 | 说明 | 备注（示例） |
|---|---|---|---|---|
| code | 是 | int | 错误码 | 0 |
| msg | 是 | string | 错误描述 | ok |
| data | 是 | object | 数据 | ... |
| data.finish | 是 | bool | 是否最后一页 | ... |
| data.msgs | 是 | array | 消息列表 | ... |
消息列表data.msgs
| 参数名 | 必选 | 类型 | 说明 | 备注（示例） |
|---|---|---|---|---|
| id | 是 | id | id | ... |
| app_id | 是 | string | 店铺id | ... |
| alive_id | 是 | string | 直播id | ... |
| comment_id | 是 | string | 评论id | ... |
| content_type | 是 | int | 消息类型 | 0-文本，1-表情，2-图片，3-语音 |
| created_at | 是 | string | 消息发送时间（发送时间相差小于5分钟的多条消息，只有第一个created_at有值） | 2022-09-23 18:30:49 |
| created_timestamp | 是 | int | 消息发送时间的时间戳（每条消息有值） | 1663929049 |
| is_can_exceptional | 是 | int | 当前消息的讲师是否允许被打赏 | 0-否，1-是 |
| is_reward_msg | 是 | int | 是否为打赏消息 | 0-否， 1-是 |
| is_vip | 是 | bool | 是否vip | false-否，true-是 |
| more_info | 是 | string | 额外的一些信息：比如语音消息文件的链接，音频 时长等 | ... |
| msg_content | 是 | string | 消息内容 | ... |
| msg_state | 是 | int | 消息可见性 | 0-可见，1-隐藏，2-已删除 |
| org_msg_content | 是 | string | 未处理的消息内容,文本或者url,语音消息则存id | ... |
| org_src_msg_content | 是 | string | 未处理的源消息内容,文本或者url,语音消息则存id | ... |
| room_id | 是 | string | im群组id | ... |
| score | 是 | int | 分数，缓存里的消息序号 | ... |
| show_on_wall | 是 | string | 该消息是否被上墙 | 0-没被上墙，1-已被上墙 |
| show_type | 是 | int | 消息显示的区域 | ... |
| src_comment_id | 是 | string | 被回复评论的id | ... |
| src_content_type | 是 | int | 源消息类型 | 0-文本，1-表情，2-图片，3-语音 |
| src_msg_content | 是 | string | 源消息内容,文本或者url,语音消息则存id | ... |
| src_nick_name | 是 | string | 本消息对应的源用户昵称，不是回复消息则为空 | ... |
| src_type | 是 | int | 被回复的消息是否为提问消息 | 0-普通消息，1-提问，2-提问已被回答 |
| src_user_id | 是 | string | 本消息对应的源用户id，不是回复消息可为空 | ... |
| src_user_type | 是 | int | 回复原消息用户身份字段 | 0-正常用户，1-讲师 |
| type | 是 | int | 是否为提问消息 | 0-普通消息，1-提问，2-提问已被回答 |
| user_id | 是 | string | 用户id | ... |
| user_title | 是 | string | 当前消息的讲师标签 | ... |
| user_type | 是 | string | 封面地址 | ... |
| vip_id | 是 | string | vip_id | ... |
| wx_avatar | 是 | string | 头像链接 | ... |
| wx_nickname | 是 | string | 用户昵称 | ... |
返回示例
{
"code": 0,
"msg": "ok",
"data": {
"finish": true,
"msgs": [
{
"alive_id": "l_6xxx3",
"app_id": "appAxxx8",
"comment_id": "07e4xxx6e",
"content_type": 0,
"created_at": "2022-11-26 16:22:55",
"created_timestamp": 1669450975,
"id": 18338333,
"is_can_exceptional": 0,
"is_reward_msg": 0,
"is_vip": false,
"more_info": "",
"msg_content": "",
"msg_state": 0,
"org_msg_content": "[火箭][火箭][火箭]",
"org_src_msg_content": "",
"room_id": "XET#Bd99b5f97a",
"show_on_wall": 0,
"show_type": 1,
"src_comment_id": "",
"src_content_type": 0,
"src_msg_content": "",
"src_nick_name": "",
"src_type": 0,
"src_user_id": "",
"src_user_type": 0,
"type": 0,
"user_id": "u_xxx",
"user_title": "",
"user_type": 0,
"vip_id": "",
"wx_avatar": "http://xxx.svg",
"wx_nickname": "Cindy"
}
]
}
}