Skip to content

查询单个用户的互动数据

请求方式及url

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://api.xiaoe-tech.com/xe.alive.single.user_interact_data.get/1.0.0
  • 频率限制: 10秒500次

请求参数

参数名必选类型说明
access_tokenstring专属token
alive_idstring直播id
user_idstring用户ID
备注
  • 查询单个用户数据前请先阅读【用户数据预热】接口的说明(店铺+直播维度,一场直播调用一次就行,缓存时间30分钟,每次查询会延长缓存时间)

  • 关于投票和问卷中的 sub_values 对象, 其中 type 代表子标题类型,目前有: select:选项类型,text:文本类型, drop_box:下拉类型 ,nameagecompanypositionphonewechat_idemail:姓名、年龄、公司、职位、手机号、微信、邮箱;实际是 text 类型,可以统一渲染成文本类型 。gender:性别类型,实际是 select 类型,但转为文本类型展示也可以。

  • multi 字段代表是否是多选的:true:多选, false:单选

  • 综上,子标题类型就三种:selecttextdrop_box,对于接口中返回的类型如果不在这三种里,可以统一转为 text 文本类型处理

请求示例

{
    "access_token": "{{TOKEN}}",
   "alive_id": "l_6620d778e4b0694cafc2c1ed",
    "user_id": "u_663f2896139a9_766MQYqp8g"
}

返回参数

参数名类型说明
codeint状态码:0-成功,其他为错误
msgstring对返回码的文本描述内容
dataobject数据列表
data.signin_timesarray点击签到时间(列表)
data.comment_countint评论数
data.question_infosarray问卷详情(列表,时间+问卷标题)
data.vote_infosarray投票详情(列表,时间+投票标题+投票内容)
data.comment_infosarray评论详情(列表,评论时间+评论内容)

问卷详情question_infos

参数名类型说明
form_idstring表单id
timestring时间
titlestring问卷标题
sub_valuesobject问卷内容
sub_values.titlestring子标题
sub_values.typestring子标题类型
sub_values.multibool是否多选,true:多选, false:单选
sub_values.optionarray子标题对应的可选值
sub_values.valuearray具体问卷值

投票详情 vote_infos

参数名类型说明
form_idstring表单id
timestring时间
titlestring问卷标题
sub_valuesobject问卷内容
sub_values.titlestring子标题
sub_values.valuearray具体投票值
sub_values.typestring子标题类型
sub_values.multibool是否多选 true:多选, false:单选
sub_values.optionarray子标题对应的可选值

评论详情 comment_infos

参数名类型说明
timestring评论时间
msgstring评论内容

返回示例

{
    "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": ["苹果", "西瓜"]
		}]
	}]
}
}