用户工具

站点工具


open:vhall_api_和讯活动数据同步接口

和讯活动数据同步接口

每个接口需要批量传入活动id,活动id之间用英文逗号分隔,如:wids=11,22,33,一次最多可传500个活动。

新增参数last_time,可选,如果传此参数,将从请求的活动中筛选出在这个日期之后的数据,否则默认查询近一小时之内的数据,在第一次获取数据时请传入一个尽可能早的时间,之后如果同步周期在一小时以内就不需要传入了。

webinar/instant-state-batch 批量获取活动即时状态

批量获取活动即时状态 频次为 5秒/次 ,只查询在last_time 参数时间内有变更的数据

URL http://e.vhall.com/api/vhallapi/v2/webinar/instant-state-batch 

请求参数

参数名 类型 必填 默认值 说明
wids string 批量的活动id,相互之间用英文逗号隔开,如:11,22,33
last_time string 有的话就筛选此时间之后的数据,如:2015-10-10 13:20:22,否则默认查询一小时内的数据

响应字段说明

字段名 类型 说明
webinar_id int 活动id
state int 活动状态
curr_online_num int 活动当前在线人数

返回示例:

{
"code": 200,
"msg": "success",
"data": {
"state": {
   "102069922": 1,
   "109525212": 1,
   "114269160": 1,
},
"curr_online_num": {
    "102795739": 10,
    "103145170": 100,
    "105157011": 33
}
}
}

webinar/info-batch 批量获取活动信息

批量获取活动信息 频次为 30秒/次 ,只查询在last_time 参数时间内有变更的数据

URL http://e.vhall.com/api/vhallapi/v2/webinar/info-batch 

请求参数

参数名 类型 必填 默认值 说明
wids string 批量的活动id,相互之间用英文逗号隔开,如:11,22,33
last_time string 有的话就筛选此时间之后的数据,如:2015-10-10 13:20:22,否则默认查询一小时内的数据

响应字段说明

字段名 类型 说明
id 活动ID
alias_name 别名,唯一,程序判断是否重复
user_id 用户ID
subject 活动标题
introduction 活动简介
img_url 封面图片
category 类别
is_open 是否公开,默认0为公开,1为不公开
layout 布局,三分屏等,1为单视频,2为“语音+文档”,3为“视频+文档”
verify 验证类别,0 无验证,1 密码,2 白名单,3 付费活动, 4 F码, 5 报名表单
password 活动设置的密码
type 1为直播,2为预约,3为结束,4为录播
is_single_video 是否单视频,1为是
is_iframe 是否允许切入,1为允许切入
auto_record 是否自动回放,1为是,2为否
is_chat 是否允许聊天,默认0为允许,1为不允许
buffer 观看方延迟
start_time 活动设置的开始时间
actual_start_time活动实际开始时间
end_time 活动结束时间默认为0,代表永久,可以手动设置结束时间或彻底结束

返回示例:

{
"code": 200,
"msg": "success",
"data": [
  {
    "id": 250031234,
    "alias_name": "",
    "user_id": "461",
    "subject": "自动创建 + 时间 :2017-01-11",
    "introduction": "sfsfdssdfsf",
    "img_url": "",
    "category": "4",
    "is_open": "0",
    "layout": 1,
    "verify": 0,
    "password": "",
    "type": 2,
    "is_single_video": 0,
    "is_iframe": 0,
    "auto_record": 1,
    "is_chat": 0,
    "money": 0,
    "exist_3rd_auth": 0,
    "buffer": 5,
    "start_time": "2017-01-11 16:28:00",
    "actual_start_time": "0000-00-00 00:00:00",
    "end_time": "0000-00-00 00:00:00"
  },
  {},
  {}
]
}

webinar/concurrency-batch 批量获取活动并发数据

批量获取活动并发数据 频次为 30秒/次 ,只查询在last_time 参数时间内有变更的数据

URL http://e.vhall.com/api/vhallapi/v2/webinar/concurrency-batch 

请求参数

参数名 类型 必填 默认值 说明
wids string 批量的活动id,相互之间用英文逗号隔开,如:11,22,33
last_time string 有的话就筛选此时间之后的数据,如:2015-10-10 13:20:22,否则默认查询一小时内的数据

响应字段说明

字段名 类型 说明
webinar_id int 活动id
last_start_time time 活动最后一次直播开始时间
last_end_time time 活动最后一次直播结束时间
last_top_online_num int 最后一次直播的最高并发
top_online_num int 活动历史最高并发

返回示例:

{
"code": 200,
"msg": "success",
"data": {
"history_max": [
  {
    "top_online_num": 1,
    "webinar_id": 815238907
  },
  {
    "top_online_num": 1,
    "webinar_id": 531725406
  }
],
"info": [
  {
    "webinar_id": 678077548,
    "last_top_online_num": 0,
    "last_start_time": "2016-10-25 18:06:03",
    "last_end_time": "2016-10-25 18:06:33"
  },
  {
    "webinar_id": 957411186,
    "last_top_online_num": 0,
    "last_start_time": "2016-10-13 10:41:10",
    "last_end_time": "0000-00-00 00:00:00"
  }
]
}
}
open/vhall_api_和讯活动数据同步接口.txt · 最后更改: 2017/06/29 18:47 由 yan.gao