证券版会议管理

新建系例会

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"
}