上传文件 API

上传文件，使用 POST 发起请求，请求地址为 /api/v1/forms/actions/upload，此接口可以直接访问，无需身份验证。

POST /api/v1/forms/actions/upload

请求 URI

参数名	类型	必填	说明
siteId	query	整数	是
formId	query	整数	否
formName	query	字符串	否
attributeName	query	字符串	是

请求 URI 可以通过传递 formId 表单 Id，也可以通过传递 formName 表单名称确定表单。

attributeName 为必填项，用于确定表单附件字段的名称。

请求 Body

提交 Content-Type 为 application/x-www-form-urlencoded 的文件。

返回

名称	类型	说明
attributeName	布尔值	表单附件字段的名称
virtualUrl	布尔值	上传附件的相对路径
fileUrl	布尔值	上传附件的绝对路径

示例

请求示例

POST /api/v1/forms/actions/upload?siteId=1&formName=表单名称&attributeName=formFile
Content-Type: application/x-www-form-urlencoded

<FORM-DATA>

返回示例

{
  "attributeName": "formFile",
  "virtualUrl": "@/upload/images/2023/11/286a4b27a647b619.png",
  "fileUrl": "/site/upload/images/2023/11/286a4b27a647b619.png"
}