跳到主要内容

插入贴纸

更新时间 2025/07/15 06:09:04

英飞画布服务端支持基于 Restful API 向画布中插入贴纸元素。

前提条件​

请求路径​

https://developer.infi.cn/infi/api/v1/boards/stickers

请求参数​

基本参数说明如下：

字段
类型
描述
必填
recordId
string
画布 ID
是
userId
string
元素创建者用户 loginName
是
element
Object
对象数据结构，详情见下方元素信息结构说明
是

元素信息结构说明如下：

字段
类型
描述
必填
icon
string
贴纸类型，详情参考下方说明
是
position.x
number
元素左上角x坐标
是
position.y
number
元素左上角y坐标
是
scale
number
贴纸缩放比例，直接影响贴纸元素的大小
是
zIndex
integer
元素层级，值为正整数
是
frameId
string
从属帧框 ID
否

说明：

  • 贴纸类型当前仅支持以下字段：start,push-hard,rush,awesome,correct-one,wrong-one,stop,give-up,warning-one,warning-two,correct-two,wrong-two,guide-board,todo-flag,start-flag,end-flag。
  • zIndex 值会影响到元素见的层级关系，位置相近的情况下，较小 zIndex 的元素会被较大 zIndex 的元素覆盖。

请求参数示例​

{
  "recordId": "SAMPLE_RECORD_ID",
  "userId": "SAMPLE_USER_LOGIN_NAME",
  "element": {
    "position": {
      "x": 100,
      "y": 100
    },
    "size": {
      "width": 1280,
      "height": 720
    },
    "icon": "start",
    "zIndex": 10
  }
}

请求 curl 示例​

curl --location --request POST \
      --header 'token: YOUR_ACCESS_TOKEN' \
      --header 'Content-Type: application/json' \
      --data '{ PAYLOADS_HERE }' \
      https://developer.infi.cn/infi/api/v1/boards/stickers

注意：请确保将 PAYLOADS_HERE 替换为请求参数中列举的数据。

请求成功情况​

响应的 Http 状态码为 200 时表示请求成功，并会带有新创建贴纸元素的 ID。 请求成功返回数据示例如下:

{
  "elementId": "SAMPLE_ELEMENT_ID"
}

请求失败情况​

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