查询单个用户的互动数据
请求方式及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": ["苹果", "西瓜"]
}]
}]
}
}