使用场景

客户有自己的会议预约系统，又想使用EPO会议门牌设备，实现在自己的会议预约系统预约会议以后，在EPO会议门牌上展示会议信息，并可实现参会人扫码签到、人脸签到等

1. 门牌注册

接口地址：POST /open-api/meeting/reg-screen

接口说明：门牌首次使用需要进行门牌注册，调用此接口将当前门牌设备进行平台注册激活。app卸载删除后，需要重新进行门牌注册。

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	描述
deviceNo	门牌序列号	String	N	二维码内容
deviceName	门牌名称	String	N	门牌名称
deviceType	门牌类型	String	N	外屏：0；内屏：1
theme	门牌主题	String	N	内屏默认：0；外屏:原生-暗影黑：an_black_1，原生-简洁白：an_white_1,科技蓝：0；外屏暗影黑：1；外屏变换彩：2
roomId	会议室id	Long	N	通过新增会议室接口获取

示例数据

{
  "deviceNo": "SN123456789",
  "deviceName": "一楼大厅门牌",
  "deviceType": "0",
  "theme": "1",
  "roomId": 1001
}

返回数据

示例数据

{
  "code": 0,
  "msg": "注册成功"
}

2. 门牌修改

接口地址：POST /open-api/meeting/update-screen

接口说明：调用此接口修改门牌信息

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	描述
deviceNo	门牌序列号	String	N	二维码内容
deviceName	门牌名称	String	N	门牌名称
deviceType	门牌类型	String	N	外屏：0；内屏：1
theme	门牌主题	String	N	内屏默认：0；外屏:原生-暗影黑：an_black_1，原生-简洁白：an_white_1,科技蓝：0；外屏暗影黑：1；外屏变换彩：2
roomId	会议室id	Long	N	通过新增会议室接口获取
isFaceSign	人脸签到	String	Y	门牌人脸签到开关，0关闭，1开启,默认关闭。人脸签到开启需联系管理员配置人脸密钥

示例数据

{
  "deviceNo": "SN123456789",
  "deviceName": "一楼大厅更新门牌",
  "deviceType": "0",
  "theme": "2",
  "roomId": 1001
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

3. 门牌解绑

接口地址：POST /open-api/meeting/delete-screen

接口说明：调用此接口解绑门牌

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	默认	描述
deviceNo	门牌序列号	String	N		二维码内容

示例数据

{
  "deviceNo": "SN123456789"
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

4. 新增会议室

接口地址：POST /open-api/meeting/add-meeting-room

接口说明：调用此接口新增新的会议室

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	描述
name	会议室名称	String	N	唯一性，存在则修改
maxPersonCount	最大容纳人数	Integer	N
image	会议室图片	String	Y	图片base64字符串
devices	会议室设备	String	Y	电视：1；电话：2；投影仪：3；白板4；视频会议：5；音响：6；话筒：7；例如：["1","2","3"]

示例数据

{
  "name": "一号会议室",
  "maxPersonCount": 20,
  "image": "base64字符串...",
  "devices": ["1", "3", "5"]
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "meetingRoomId": 11111
  }
}

5. 修改会议室

接口地址：POST /open-api/meeting/update-meeting-room

接口说明：调用此接口修改会议室信息

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	描述
roomId	会议室id	Long	N
name	会议室名称	String	N
maxPersonCount	最大容纳人数	Integer	N
image	会议室图片	String	Y	图片base64字符串
devices	会议室设备	String	Y	电视：0；电话：1；投影仪：2；白板3；视频会议：4；音响：5；话筒：6；例如：["1","2","3"]

示例数据

{
  "roomId": 11111,
  "name": "一号会议室（更新）",
  "maxPersonCount": 25,
  "image": "新的base64字符串...",
  "devices": ["0", "1", "2", "3"]
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

6. 删除会议室

接口地址：POST /open-api/meeting/delete-meeting-room

接口说明：调用此接口删除会议室信息

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	默认	描述
roomId	会议室id	Long	N

示例数据

{
  "roomId": 11111
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

7. 会议新增

接口地址：POST /open-api/meeting/add-meeting

接口说明：调用此接口新增新的会议预约

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	描述
name	会议名称	String	N
roomId	会议室id	Long		调用会议室新增获取roomId
userId	预约人用户id	Long	N	调用接口新增用户获取userId
userStr	参会人id字符串	String	N	参会人ids，逗号分割
meetStartTime	会议开始时间	String	N	yyyy-MM-dd HH:mm
meetEndTime	会议结束时间	String	N	yyyy-MM-dd HH:mm
meetSignInStartTime	会议签到开始时间	String	Y	HH:mm
meetSignInEndTime	会议签到结束时间	String	Y	HH:mm
signInType	签到方式	String	N	0无需签到1扫码签到 3人脸签到
4扫码或人脸签到

示例数据

{
  "name": "项目启动会",
  "roomId": 11111,
  "userId": 2001,
  "userStr": "2002,2003,2004",
  "meetStartTime": "2025-08-01 09:00",
  "meetEndTime": "2025-08-01 11:00",
  "meetSignInStartTime": "08:30",
  "meetSignInEndTime": "09:10",
  "signInType": "1"
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "meetingId": 3001
  }
}

8. 会议修改

接口地址：POST /open-api/meeting/update-meeting

接口说明：调用此接口修改会议信息

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	默认	描述
meetingId	会议id	Long	N
name	会议名称	String	N

示例数据

{
  "meetingId": 3001,
  "name": "项目启动会（更新）"
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

9. 会议删除

接口地址：POST /open-api/meeting/delete-meeting

接口说明：调用此接口删除会议信息

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	默认	描述
meetingId	会议id	Long	N
userId	创建人id	Long	N

示例数据

{
  "meetingId": 3001,
  "userId": 2001
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

10. 新增用户

接口地址：POST /open-api/meeting/add-user

接口说明：调用此接口新增用户信息，预约人、参会人都属于用户

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	描述
name	姓名	String	N
mobile	手机号	String	Y	同组织内唯一
headImage	头像	String	Y	图片base64字符串
facePhoto	人脸照片	String	Y	图片base64字符串，校验照片质量
role	角色	String	Y	管理员：admin普通用户：user，默认为：user
age	年龄	Integer	Y
sex	性别	String	Y	0未知 1男 2女

示例数据

{
  "name": "张三",
  "headImage": "base64字符串...",
  "age": 30,
  "sex": "1"
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "userId": 11111
  }
}

11. 修改用户

接口地址：POST /open-api/meeting/update-user

接口说明：调用此接口修改用户信息，预约人、参会人都属于用户

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	描述
userId	用户id	Long	N
name	姓名	String	N
mobile	手机号	String	Y	同组织内唯一
headImage	头像	String	Y	图片base64字符串
facePhoto	人脸照片	String	Y	图片base64字符串，校验照片质量
role	角色	String	Y	管理员：admin普通用户：user，默认为：user
age	年龄	Integer	Y
sex	性别	String	Y	0未知 1男 2女

示例数据

{
  "userId": 11111,
  "name": "张三三",
  "headImage": "新的base64字符串...",
  "age": 31,
  "sex": "1"
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

12. 删除用户

接口地址：POST /open-api/meeting/delete-user

接口说明：调用此接口删除用户信息，预约人、参会人都属于用户

请求数据

header域

参数	名称	类型	可空	默认	描述
AccessToken	访问令牌	String	N		接口1获取

Body域

参数	名称	类型	可空	默认	描述
userId	用户id	Long	N

示例数据

{
  "userId": 11111
}

返回数据

示例数据

{
  "code": 0,
  "msg": "操作成功"
}

13. 三方鉴权【内测中】

接口说明：提供的回调url需接受 post application/json请求。刷脸、刷卡、钉工牌、二维码识别等鉴权场景

请求数据

header域

名称	类型	可空	描述
appKey	String	N	平台分配
timestamp	Long	N	当前时间，Unix毫秒时间戳
sign	String	N	MD5-32(appKey+timestamp+appSecret),32小写

body域

名称	类型	可空	描述
callbackType	String	N	MEETING-CHECK
data	对象	N
+checkType	string	N	核验方式
+data	string	N	checkType=face为人脸id，checkType=card 为卡号，checkType = code 为二维码数据
+deviceNo	string	N	门牌序列号

返回数据

名称	类型	可空	描述
code	int	N	0成功 1失败
message	string	N	说明
status	int	N	0成功，1失败
checkType	string	N	face，card，code
faceId	string		人脸id
userId	string		用户id
userName	string		用户姓名
content	string		展示内容
ttsContent	string		播报内容

示例数据

{
  "userId": 11111
}

返回数据

{
  "code": 0,
  "msg": "操作成功"
}

会议平台接口

使用场景#

1. 门牌注册#

2. 门牌修改#

3. 门牌解绑#

4. 新增会议室#

5. 修改会议室#

6. 删除会议室#

7. 会议新增#

8. 会议修改#

9. 会议删除#

10. 新增用户#

11. 修改用户#

12. 删除用户#

13. 三方鉴权【内测中】#

使用场景

1. 门牌注册

2. 门牌修改

3. 门牌解绑

4. 新增会议室

5. 修改会议室

6. 删除会议室

7. 会议新增

8. 会议修改

9. 会议删除

10. 新增用户

11. 修改用户

12. 删除用户

13. 三方鉴权【内测中】