证券版会议管理
新建系例会
1. 接口描述
接口名称:
/eventopenapi/series/event/create
发送方式:
POST
参数格式:
accept: application/json;content-type: application/json
2. 输入参数
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
token | String | 是 | 统一鉴权token |
calType | String | 是 | RP:序列会父会 R:序列会子会 F:策略会父会 FB:论坛会 FC:上市公司交流会 |
meetingType | Integer | 否 | 会议类型 1:分析师会议 2:上市公司会议 3:专家会议 4:小范围交流会 5.晨会 6.在线培训 7.指定范围会议, 系例会/策略会父会不需要此参数 |
hostId | Long | 否 | 主持人ID(可通过 https://developer.quanshi.com/cn/api/122 查询) 会议参会人列表 系列会/策略会父会不需要 子会需要 |
title | String | 是 | 会议主题, 主题不能超过30个字 |
liveCover | String | 否 | 活动间(直播)封面图URL 尺寸1280x720px 图片小于2MB(jpg、png) |
summary | String | 否 | 会议简介 简介内容不能超过500个字, 目前支持受限的Html标记 分段:p, span, ul, li, br 图形:img 字体:strong, em, u |
extraInfo | JSON | 否 | 会议扩展信息 |
calType | String | 是 | RP:序列会父会 R:序列会子会 F:策略会父会 FB:论坛会 FC:上市公司交流会 |
listedCompany | JSON | 否 | 上市公司名称, meetingType=2时必填 |
isSamePassword | Integer | 是 | 系例会/策略会子会密码是否相同 1:相同 0:不相同 |
participants | Json | 否 | 会议参会人列表 系列会/策略会父会不需要 子会需要 |
startTime | Long | 否 | 开始时间(时间戳,单位秒)会议参会人列表 系列会/策略会父会不需要 子会需要 |
length | Int | 否 | 会议时长(单位分钟) 会议参会人列表 系列会/策略会父会不需要 子会需要 |
extraInfo
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
recommends | Array | 否 | 直播转播平台,1:在企业站点上公开, 8:每市, 16: choice, 32: 同花顺 |
recommendJoinLimit | Int | 否 | 直播转播观看条件, 1: 仅企业白名单客户才可参会, 7: 平台所有机构投资者均可参会 |
joinLimits | Int | 否 | 观看条件 0:所有人均可参会 1:仅企业白名单客户 6:报名客户 7:全时机构客户 |
liveConfig | JSON | 否 | 观看条件 0:所有人均可参会 1:仅企业白名单客户 6:报名客户 7:全时机构客户 |
extraInfo->listedCompany
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
customerName | String | 否 | 上市公司名称 |
stockCode | Integer | 否 | 代码 |
extraInfo->liveConfig
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
enrollApproval | Integer | 否 | 1:需要审批 0:不需要审批 |
3. 输出参数
参数 | 类型 | 说明 |
---|---|---|
timeStamp | Long | 返回时间(时间戳,单位毫秒) |
requestId | String | 请求ID(在接口异常时, 需提供请求ID) |
code | Int | 返回的状态码 |
msg | String | 当返回结果的状态码不为200时,包含的错误信息 |
data | Json | 返回数据 |
data 参数说明
参数 | 类型 | 说明 |
---|---|---|
eventId | Long | 直播会议ID |
title | String | 会议主题 |
startTime | Long | 会议开始时间(时间戳,单位秒) |
length | Int | 会议时长(时间戳,单位分钟) |
eventForm | Int | 会议形式 1: 电话活动,3: 网络会议,4: 实时互动直播,7: 大型直播活动 |
summary | String | 会议概要 |
hostId | Long | 主持人ID |
billingCode | String | 云会议计费BC |
conferenceId | String | 云会议ID |
pcode1 | String | 主持人入会密码 |
pcode2 | String | 参会人入会密码 |
hostJoinUrl | String | 主持人入会链接 |
joinHostUrl | String | 助理主持人链接 |
guestJoinUrl | String | 嘉宾入会链接 |
audienceUnionUrl | String | 参会者链接 |
testAudienceUnionUrl | String | 测试会参会者链接 |
liveCover | String | 活动间(直播)封面图URL |
callbackUrl | String | 会议回调地址 |
liveScreen | Int | 云活动手机屏幕显示方式,0: 横屏,1:竖屏 |
manualService | Int | 是否需要项目经理开关,1:开启,2:关闭 |
liveLag | Int | 直播延迟设置 0:正常延迟,1:无延迟 |
labels | Array | 活动标签 |
customStr | String | 自定义内容 |
liveOpenFlag | Int | 开启实时互动直播 0: 否, 1: 是(仅针对eventForm=3有效) |
joinLimit | Int | 观众直播入会限制 0: 公开, 1: 白名单(非白名单(电话入会)拒绝入会) |
extraInfo | Json | 会议扩展信息 |
btplRole | Json | 专业活动角色信息 |
liveStreamUrl | Json Array | 直播平台拉流地址,当请求参数 isReturnLiveStreamUrl = 1 时返回 |
liveCode | String | 直播码,只有genLiveCode=1时,才会有值 |
extraInfo 参数
参数 | 类型 | 说明 |
---|---|---|
isTest | Int | 是否需要测试会议 0:否,1:是 |
isPublic | Int | 公共活动类型 0:非公开,1:公开 |
btplId | Int | 业务模板ID |
btplName | String | 业务模板名称 |
parentEventId | Long | 母直播的eventId |
parentRecordList | JSON | 转播录制ID数组 |
isDisableRecord | Int | 直播录制是否自动录制 1:手动录制, 0:自动录制 |
recommends | Array | 直播转播平台,1:在企业站点上公开, 8:每市, 16: choice, 32: 同花顺 |
recommendJoinLimit | Int | 直播转播观看条件, 1: 仅企业白名单客户才可参会, 7: 平台所有机构投资者均可参会 |
btplRole 参数
参数 | 类型 | 说明 |
---|---|---|
roleId | Int | 角色ID |
roleName | String | 角色名称 |
managerType | Int | 管理类型 1:管理者,2:辅助管理者(联席主持人),3:参会人, -1: 企业管理者 |
joinconfway | Int | 入会方式 1: 电话,2: 网络,3: 电话+网络,4: 直播 |
link | String | 入会链接 |
internallink | String | 内部使用链接 |
4. 示例
输入示例1: 创建系例会父会
{
"meetingType":2,
"liveCover":"https://www.quanshi.com/themes/quanshi/images/case-yiliao.png",
"title":"{{title}}",
"extraInfo":{
"recommends":[1,2,4],
"joinLimits":[6],
"liveConfig":{"enrollApproval":0}
},
"summary":"this is a test",
"calType":"RP",
"isSamePassword":1
}
输入示例2: 创建系例会子会
{
"liveCover":"https://www.quanshi.com/themes/quanshi/images/case-yiliao.png",
"title":"{{title}}",
"extraInfo":{
"recommends":[1,2,4,8,16],
"joinLimits":[1],
"listedCompany":{
"customerName":"2233",
"stockCode":"122222"
}
},
"summary":"this is a test",
"calType":"R",
"hostId":{{userId}},
"length":30,
"startTime":{{startTime}},
"manualService":1,
"meetingForm":2,
"parentId":657328
}
输入示例3: 创建策略会父会
{
"liveCover":"https://www.quanshi.com/themes/quanshi/images/case-yiliao.png",
"title":"{{title}}",
"summary":"this is a test",
"calType":"F",
//"hostId":{{userId}},
"startTime":{{startTime}},
"length":3000
}
输入示例4: 创建策略会子会---论坛会
{
"meetingType":2,
"liveCover":"https://www.quanshi.com/themes/quanshi/images/case-yiliao.png",
"title":"{{title}}",
"extraInfo":{
"recommends":[1,2,4,8,16],
"joinLimits":[1]
},
"summary":"this is a test",
"calType":"FB",
"hostId":{{userId}},
"length":60,
"startTime":{{startTime}},
"manualService":0,
"meetingForm":1,
"parentId":657330
}
输入示例4: 创建策略会子会---上市会议
{
"meetingType":2,
"liveCover":"https://www.quanshi.com/themes/quanshi/images/case-yiliao.png",
"title":"{{title}}",
"extraInfo":{
"recommends":[1,2,4,8,16],
"joinLimits":[1]
},
"summary":"this is a test",
"calType":"FC",
"hostId":{{userId}},
"length":60,
"startTime":{{startTime}},
"manualService":0,
"meetingForm":1,
"parentId":657330
}
输出示例
{
"timeStamp": 1729056919655,
"code": 200,
"msg": "Successfully to create the event!",
"data": {
"summary": "this is a test",
"eventId": 657341,
"hostName": "new255",
"hostJoinUrl": "https://stest.qsh1.cn/a/HVIZeX556260",
"hostId": 88589613,
"title": "2024-10-18 14:35:18 会议",
"parentId": null,
"joinHostUrl": "https://stest.qsh1.cn/a/GVIZeXD76177",
"pcode2": "201501000037768088",
"billingCode": "95531303",
"pcode1": "201501000037768087",
"conferenceId": "239836699",
"audienceUnionUrl": "https://ltest.qsh1.cn/activity/gektRgcWl",
"btplRole": [
{
"link": "https://stest.qsh1.cn/a/HVIZeX556260",
"roleId": 1000,
"roleName": "主持人",
"managerType": 1,
"internallink": null,
"joinconfway": 898
},
{
"link": "https://stest.qsh1.cn/a/GVIZeXD76177",
"roleId": 1001,
"roleName": "联席主持人",
"managerType": 2,
"internallink": null,
"joinconfway": 3987
},
{
"link": "https://ltest.qsh1.cn/activity/gektRgbWl",
"roleId": 1003,
"roleName": "嘉宾",
"managerType": 3,
"internallink": "https://ntest.qsh1.cn/k/mLiyljhXQeg?jointid=q0ZfoN_SzB_yBMS_gnw-TvzH7HQYtAcbSKn1tq0E5NVtiGIl5w1U9JcQepjFjKzl",
"joinconfway": 899
},
{
"link": "https://ltest.qsh1.cn/activity/gektRgcWl",
"roleId": 1004,
"roleName": "观众",
"managerType": 3,
"internallink": "https://ntest.qsh1.cn/k/mLiyljhXQeg?jointid=q0ZfoN_SzB_yBMS_gnw-TvzH7HQYtAcbSKn1tq0E5NXgiLey6i6LmfbRd7rPcFWC",
"joinconfway": 4
}
],
"startTime": 1729057818,
"guestJoinUrl": "https://ntest.qsh1.cn/k/mLiyljhXQeg?jointid=q0ZfoN_SzB_yBMS_gnw-TvzH7HQYtAcbSKn1tq0E5NVtiGIl5w1U9JcQepjFjKzl",
"extraInfo": {
"btplId": 126999,
"btplName": "上市公司会议",
"rebroadcast": null,
"parentEventId": null,
"parentRecordList": null,
"_rebroadcastform": null,
"_parentRecordList": null,
"isPublic": null,
"customStr": null,
"genLivecode": null,
"meetingHub": null,
"recommends": [
1,
2,
4,
8,
16
],
"recommendJoinLimit": null,
"isReturnLiveStreamUrl": null,
"isDisableRecord": null,
"joinLimits": [
1
],
"listedCompany": {
"customerName": "2233",
"stockCode": "122222"
},
"mtgHubInfo": null,
"liveConfig": null
}
},
"requestId": "127.0.0.1-1729056918623.4696413"
}