上传图片资源接口

上传图片或其他文件资源到系统中，支持指定资源分类，可用于替换已有资源。系统会自动处理图片尺寸并生成缩略图。

注意事项

• 此接口使用 POST 方法，Content-Type 为 form-data
• 上传文件需要用户登录并具有相应的上传权限
• 支持上传图片文件，系统会自动获取图片尺寸信息
• 可以通过指定 id 参数来替换已有资源
• 系统会自动生成缩略图并计算文件 MD5 值

请求地址

{域名地址}/api/attachment/upload

说明：{域名地址} 需要替换成你的域名地址，如 https://www.anqicms.com/api/attachment/upload

请求语法

POST {域名地址}/api/attachment/upload
Content-Type: multipart/form-data

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求参数

响应头

此接口仅涉及公共相应头。更多信息，请参见公共请求头（Common Request Headers）。

返回参数

data 参数

使用示例

请求示例

POST /api/attachment/upload HTTP/1.1
Host: your-domain.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="category_id"

1
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="example.jpg"
Content-Type: image/jpeg

(file content)
------WebKitFormBoundary7MA4YWxkTrZu0gW--

响应示例

{
  "code": 0,
  "data": {
    "id": 213,
    "created_time": 1662734332,
    "updated_time": 1662734332,
    "file_name": "AnqiCMS",
    "file_location": "uploads/202209/09/5632dd13c746a365.webp",
    "file_size": 9348,
    "file_md5": "4fae2c295632dd13c746a3653227f93a",
    "width": 160,
    "height": 160,
    "category_id": 0,
    "is_image": 1,
    "status": 1,
    "logo": "https://www.anqicms.com/uploads/202209/09/5632dd13c746a365.webp",
    "thumb": "https://www.anqicms.com/uploads/202209/09/thumb_5632dd13c746a365.webp"
  },
  "msg": ""
}

错误代码