导入图片资源接口

导入图片资源到系统中，支持指定资源分类、替换已有资源等功能。该接口主要用于后台内容管理系统的图片上传和管理。

注意事项

• 该接口采用POST方法，使用form-data格式提交数据
• 需要提供有效的后台导入接口Token进行身份验证
• 支持指定图片资源分类ID
• 支持替换已存在的图片资源（通过ID指定）
• 上传成功后返回图片的详细信息和访问地址

请求地址

{域名地址}/attachment/upload?token={token}

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

请求语法

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

请求参数

GET 参数

POST 参数

返回参数

data 参数

使用示例

请求示例

curl -X POST \
  'https://www.anqicms.com/attachment/upload?token=your_token_here' \
  -H 'Content-Type: multipart/form-data' \
  -F 'category_id=1' \
  -F 'file=@/path/to/your/image.jpg'

或使用表单方式：

POST /attachment/upload?token=your_token HTTP/1.1
Host: www.anqicms.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": "example.jpg",
    "file_location": "uploads/202209/09/5632dd13c746a365.webp",
    "file_size": 9348,
    "file_md5": "4fae2c295632dd13c746a3653227f93a",
    "width": 160,
    "height": 160,
    "category_id": 1,
    "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": ""
}

错误响应示例

{
  "code": -1,
  "msg": "文件类型不允许上传"
}

错误代码