用户工具

站点工具


open:vhall_api_to益盟_增加返回third_user_id

report/attendee-records 获取直播活动用户访问记录

获取直播活动用户访问记录

URL http://e.vhall.com/api/vhallapi/v2/report/attendee-records 

请求参数

参数名 类型 必选 说明
webinar_id int 活动ID 9位数字

响应参数

返回形如{“code”:200,”msg”:“success”,”data”:{'ip':'127.0.0.1','name':'nelson','email':'gaoyan@vhall.com'}}的json。data部分数据如下:

参数名 类型 必选 说明
lists json 获取成功,返回列表数据(JSON格式)

list数据

参数名 类型 必选 说明
third_user_id 第三方用户id,与第三方创建用户传入的值一致
email string 邮箱
name string 昵称
ip string ip地址
refer string 来源信息,客户自定义的

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
       'ip':'127.0.0.1',
       'third_user_id':'123456789''name':'nelsonking',
       'email':'gaoyansing@sina.com'
           }
}

错误码

code 含义
10017 活动id为空
10010 活动不存在
10011 不是自己的活动

report/track 获取活动观众观看记录

获取活动观众观看记录

URL http://e.vhall.com/api/vhallapi/v2/report/track 

请求参数

参数名 类型 必选 说明
webinar_id int 9位数字,活动ID
type int 1为直播,2为回放,默认为直播
pos int 数字,分页开始
limit int 数字,返回条数

响应参数

返回形如{“code”:200,”msg”:“success”,”data”:{'list':['name':'nelson','email':'gaoyan@vhall.com'],'total':1}}的json。data部分数据如下:

参数名 类型 必选 说明
{“lists”:{},”total”:“10”} json 获取成功,返回列表数据(JSON格式)

list数据

参数名 类型 必选 说明
third_user_id string 第三方用户id,与第三方创建用户接口中传入的值一致
name string 昵称
email string 邮箱
start_time string 进入时间,形式如2013-10-01 10:10
end_time string 离开时间,回放和点播时不返回此参数
duraion string 观看时长
platform int 观看端类型,1为微吼直播App,2为WAP,3为PC,6为SDK

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
    	'lists' : [
	        {
            'third_user_id':'12345678'
            'name' : 'nelsonking',
            'email': 'gaoyansing@sina.com',
            'start_time' : '2015-11-25 16:05',
            'end_time' : '2015-11-25 17:05',
            'duration': '10',
            'platform': '1'
            }
        ],
        'total': 1
	}
}

错误码

code 含义
10017 活动id为空
10010 活动不存在
10011 不是自己的活动

chat/history 获取活动历史聊天记录

获取活动历史聊天记录

URL http://e.vhall.com/api/vhallapi/v2/chat/history 

请求参数

参数名 类型 必选 说明
webinar_id int 活动ID
start_time time 形如2016-11-30 10:16:43,只获取在该时间后的
end_time time 形如2016-11-30 10:16:43,只获取在该时间前的
pos int 分页开始 数字
limit int 返回条数 数字

响应参数

返回形如{“code”:200,”msg”:“success”,”data”:{'list':[{'webinar_id':123,'name':'nelson'}]},'total':1}的json。data部分数据如下:

参数名 类型 必选 说明
{“lists”:{},”total”:“10”} json 获取成功,返回列表数据(JSON格式)

list数据

参数名 类型 必选 说明
webinar_id int 活动ID
third_user_id string 第三方用户id,与第三方创建用户接口中传入的值一致
name string 用户昵称
email string 用户邮箱
text string 对话内容
create_time string 对话时间形式如2013-10-01 10:10:10

响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
    	'lists': [
	        {
            	'webinar_id' : 654067993,
                'third_user_id':'12345678'
                'name' : 'v461',
                'email': 'gaoyansing@sina.com',
                'text': 'hello world',
                'create_time' : '2015-11-12 16:05:27'
			},
	        {
            	'webinar_id' : 654067993,
                'name' : 'v461',
                'email': 'gaoyansing@sina.com',
                'text': 'hello every one',
                'create_time' : '2015-11-12 16:05:29'
			},
		    ],
        'total':2
	}
}

错误码

code 含义
10017 活动id为空
10010 活动不存在
10011 不是自己的活动
open/vhall_api_to益盟_增加返回third_user_id.txt · 最后更改: 2016/12/29 18:10 由 rui.jiang