Appearance
查询单个用户的互动数据
请求方式及url
- 请求方式:
POST - 请求头:
Content-Type:application/json - 接口地址:
https://api.xiaoe-tech.com/xe.alive.single.user_interact_data.get/1.0.0 - 频率限制:
10秒500次
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 专属token |
| alive_id | 是 | string | 直播id |
| user_id | 是 | string | 用户ID |
备注
查询单个用户数据前请先阅读【用户数据预热】接口的说明(店铺+直播维度,一场直播调用一次就行,缓存时间30分钟,每次查询会延长缓存时间)
关于投票和问卷中的 sub_values 对象, 其中
type代表子标题类型,目前有:select:选项类型,text:文本类型,drop_box:下拉类型 ,name、age、company、position、phone、wechat_id、email:姓名、年龄、公司、职位、手机号、微信、邮箱;实际是 text 类型,可以统一渲染成文本类型 。gender:性别类型,实际是 select 类型,但转为文本类型展示也可以。multi字段代表是否是多选的:true:多选, false:单选综上,子标题类型就三种:
select、text、drop_box,对于接口中返回的类型如果不在这三种里,可以统一转为 text 文本类型处理
请求示例
{
"access_token": "{{TOKEN}}",
"alive_id": "l_6620d778e4b0694cafc2c1ed",
"user_id": "u_663f2896139a9_766MQYqp8g"
}返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码:0-成功,其他为错误 |
| msg | string | 对返回码的文本描述内容 |
| data | object | 数据列表 |
| data.signin_times | array | 点击签到时间(列表) |
| data.comment_count | int | 评论数 |
| data.question_infos | array | 问卷详情(列表,时间+问卷标题) |
| data.vote_infos | array | 投票详情(列表,时间+投票标题+投票内容) |
| data.comment_infos | array | 评论详情(列表,评论时间+评论内容) |
问卷详情question_infos
| 参数名 | 类型 | 说明 |
|---|---|---|
| form_id | string | 表单id |
| time | string | 时间 |
| title | string | 问卷标题 |
| sub_values | object | 问卷内容 |
| sub_values.title | string | 子标题 |
| sub_values.type | string | 子标题类型 |
| sub_values.multi | bool | 是否多选,true:多选, false:单选 |
| sub_values.option | array | 子标题对应的可选值 |
| sub_values.value | array | 具体问卷值 |
投票详情 vote_infos
| 参数名 | 类型 | 说明 |
|---|---|---|
| form_id | string | 表单id |
| time | string | 时间 |
| title | string | 问卷标题 |
| sub_values | object | 问卷内容 |
| sub_values.title | string | 子标题 |
| sub_values.value | array | 具体投票值 |
| sub_values.type | string | 子标题类型 |
| sub_values.multi | bool | 是否多选 true:多选, false:单选 |
| sub_values.option | array | 子标题对应的可选值 |
评论详情 comment_infos
| 参数名 | 类型 | 说明 |
|---|---|---|
| time | string | 评论时间 |
| msg | string | 评论内容 |
返回示例
{
"code": 0,
"msg": "ok",
"data":{
"question_infos": [{
"form_id": "form_ccw362109e477b122cecac1er56",
"time": "2024-07-06 17:00:00",
"title": "这是一个问卷, 你喜欢什么?",
"sub_values": {
"title": "喜欢什么水果?",
"value": ["西瓜"],
"type": "select",
"multi": true,
"option": ["苹果", "西瓜"]
}
}],
"comment_count": 0,
"comment_infos": [
],
"signin_times": [
],
"vote_infos": [{
"form_id": "form_533362109e477b122cecac14c1a",
"time": "2024-07-06 12:00:00",
"title": "这是一个投票, 你喜欢什么水果",
"sub_values": [{
"title": "",
"value": ["苹果"],
"type": "select",
"multi": false,
"option": ["苹果", "西瓜"]
}]
}]
}
}