跳到主要内容

获取投票列表

更新时间 2025/02/27 09:24:51

英飞画布服务端支持基于 Restful API 获取通过开发者门户创建的模板列表信息。

前提条件​

请求路径​

https://developer.infi.cn/infi/api/v1/boards/voteData
  • 请求参数
字段
类型
描述
recordId
string
画布ID

请求 curl 示例​

curl --location --request GET \
      --header 'token: YOUR_ACCESS_TOKEN' \
      --header 'Content-Type: application/json' \
      https://developer.infi.cn/infi/api/v1/boards/voteData?recordId={recordId}

请求成功情况​

响应的 Http 状态码为 200 时表示请求成功，并会返回模板列表信息。

请求成功返回数据示例如下:

{
  "data": [
        {
          "anonymous": true,
          "creator": "USER_ID",
          "duration": 300000,
          "elementTypes": [7],
          "elements": [
            {
              "elementId": "ELEMENT_ID_1",
              "snapshot": {
                "height": 850.1219903744897,
                "pngFileId": "67c02856e3886900016ca4f2",
                "svgFileId": "67c02856e3886900016ca4f3",
                "width": 850.1219903744895
              },
              "text": "TEXT_1"
            },
            {
              "elementId": "ELEMENT_ID_2",
              "snapshot": {
                "height": 850.1219903744897,
                "pngFileId": "67c02854e3886900016ca4f1",
                "svgFileId": "67c02854e3886900016ca4f0",
                "width": 850.1219903744895
              },
              "text": "TEXT_2"
            }
          ],
          "id": "ID",
          "name": "VOTE_NAME",
          "numberOfVoted": 1,
          "results": [
            {
              "detail": [[null, 1]],
              "elementId": "ELEMENT_ID_1",
              "total": 1
            }
          ],
          "startTime": 1740646478617,
          "status": 1,
          "tickets": 1
        }
      ]
}

成功返回的字段说明如下：

字段
类型
描述
data
ArrayVoteDataType
投票数组，数组元素结构请参考下方说明

VoteDataType 结构体说明如下：

字段
类型
描述
id
string
投票记录 ID
name
string
投票名称
creator
string
创建者用户 ID
startTime
integer
投票开始时间
duration
integer
投票持续时间
tickets
integer
每人可投票数
anonymous
string
是否匿名
numberOfVoted
integer
已投票人数
status
integer
投票状态：0 表已创建；1 表已结束
elementTypes
array[string]
投票相关元素类型数组
elements
ArrayElementsDataType
投票元素数组， 数组元素结构请参考下方说明
results
ArrayResultDataType
投票结果，按总票数降序排列，数组元素结构请参考下方说明

元素类型:

0：根元素，1：线条，2：frame，3:文本，4：图形，5：连接线，6：图片，7：贴纸，8：pdf/ppt/excel/word文件，9：脑图节点，10：脑图连接线， 11：文字评论，12：视频，13：表格，14：表格文本，15：音频，16：网页，17：定时器，18：看板，19：卡片，20：大文档，21：图形库

ElementsDataType 结构体说明如下：

字段
类型
描述
elementId
string
元素 ID
text
string
元素文本内容数据
snapshot
object
元素快照数据
comments
array[string]
附着在投票元素上的评论 ID

ResultDataType 结构体说明如下：

字段
类型
描述
elementId
string
元素 ID
total
integer
投票总数
detail
ArrayVoteDetailType
投票人员详情,数组元素结构请参考下方说明

VoteDetailType 结构体说明如下：

字段
类型
描述
userId
string / null
投票用户ID，匿名投票为null
voteCount
string
投票数

请求失败情况​

响应的 Http 状态码不为 200 时表示请求失败，如需更多信息请参考请求错误说明文档。