桌牌平台接口（内测）

1. 添加网关设备

接口地址：POST /open-api/board/add-gateway-device

接口说明：通过此接口将网关设备添加到EPO平台

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
name	string	N		网关名称
sn	string	N		网关序列号

返回数据

名称	类型	可空	默认	描述
code	int	N		返回状态
msg	string	N		返回说明

示例数据

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

2. 修改网关设备

接口地址：POST /open-api/board/update-gateway-device

接口说明：通过此接口修改网关名称

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
name	string	N		网关名称
sn	string	N		网关序列号

返回数据

名称	类型	可空	默认	描述
code	int	N		返回状态
msg	string	N		返回说明

示例数据

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

3. 删除网关设备

接口地址：POST /open-api/board/delete-gateway-device

接口说明：通过此接口删除网关

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
sn	string	N		网关序列号

返回数据

名称	类型	可空	默认	描述
code	int	N		返回状态
msg	string	N		返回说明

示例数据

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

4. 更新桌牌数据

接口地址：POST /open-api/board/update-data

接口说明：通过此接口刷新桌牌数据

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	描述
mac	string	N	Mac地址
templateCode	string	N	模板编号
name	string	Y	姓名
companyName	string	Y	公司名称
meetingName	Object	N	会议名称
deptName	string	Y	部门名称
postName	string	Y	职位

返回数据

名称	类型	可空	默认	描述
code	int	N		返回状态
msg	string	N		返回说明

示例数据

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

5. 删除桌牌设备

接口地址：POST /open-api/board/delete-board-device

接口说明：通过此接口删除桌牌设备

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
mac	string	N		Mac地址

返回数据

名称	类型	可空	描述
code	int	N	返回状态
msg	string	N	返回说明
data	Object	N
+recordId	long	N	记录id

示例数据

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

6. 获取模板列表

接口地址：POST /open-api/board/template-list

接口说明：通过此接口获取组织下的桌牌模板列表

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

返回数据

名称	类型	可空	描述
code	Int	N	0成功，1失败
msg	String		提示信息
result	Object	N
+data	Object[]	Y
++templateName	String	N	模板名称
++templateCode	String	N	模板编号
++boardDeviceModel	String	N	桌牌设备型号，表示此模板只有这个型号的才能使用
++boardDeviceModelName	String	N	桌牌设备型号名称
++templateImage	String	Y	模板样式图
++showLogo	String	N	此模板是否展示公司logo
++items	Object	N	模板含有字段列表
+++name	String	Y	姓名
+++companyName	String	Y	公司名称
+++meetingName	String	Y	会议名称
+++deptName	String	Y	部门名称
+++postName	String	Y	职位

示例数据

{
  "code": 0,
  "msg": "查询成功",
  "result": {
    "data": [
      {
        "templateName": "标准会议桌牌模板",
        "templateCode": "TEMPLATE_001",
        "boardDeviceModel": "DP-8800",
        "boardDeviceModelName": "8寸电子桌牌",
        "templateImage": "https://example.com/templates/001.png",
        "showLogo": "Y",
        "items": {
          "name": "张三",
          "companyName": "XX科技有限公司",
          "meetingName": "2025年度战略研讨会",
          "deptName": "研发部",
          "postName": "高级工程师"
        }
      },
      {
        "templateName": "简约嘉宾桌牌模板",
        "templateCode": "TEMPLATE_002",
        "boardDeviceModel": "DP-7700",
        "boardDeviceModelName": "7寸电子桌牌",
        "templateImage": null,
        "showLogo": "N",
        "items": {
          "name": "李四",
          "companyName": null,
          "meetingName": "行业交流会",
          "deptName": null,
          "postName": "CEO"
        }
      }
    ]
  }
}

7. 上传公司logo

接口地址：POST /open-api/board/upload-log

接口说明：通过此接口上传公司logo图标

请求数据

header域

名称	类型	可空	默认	描述
AccessToken	String	N		接口1获取

body域

名称	类型	可空	默认	描述
logo	string	N		base64字符串，1M以内

返回数据

名称	类型	可空	默认	描述
code	int	N		返回状态
msg	string	N		返回说明

示例数据

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

1. 添加网关设备#

2. 修改网关设备#

3. 删除网关设备#

4. 更新桌牌数据#

5. 删除桌牌设备#

6. 获取模板列表#

7. 上传公司logo#

1. 添加网关设备

2. 修改网关设备

3. 删除网关设备

4. 更新桌牌数据

5. 删除桌牌设备

6. 获取模板列表

7. 上传公司logo