查询单个用户的互动数据

请求方式及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:下拉类型 ,nameagecompanypositionphonewechat_idemail:姓名、年龄、公司、职位、手机号、微信、邮箱;实际是 text 类型,可以统一渲染成文本类型 。gender:性别类型,实际是 select 类型,但转为文本类型展示也可以。
  • multi 字段代表是否是多选的:true:多选, false:单选

  • 综上,子标题类型就三种:selecttextdrop_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": ["苹果", "西瓜"]
        }]
    }]
}
}

results matching ""

    No results matching ""