Import image resource interface

Import image resources into the system, supporting functions such as specifying resource categories, replacing existing resources, etc. This interface is mainly used for image upload and management in the background content management system.

Points to note

• This interface uses the POST method to submit data in form-data format
• An effective background import interface Token is required for authentication
• Supports specifying the image resource category ID
• Supports replacing existing image resources (specified by ID)
• Returns detailed information and access address of the image after upload

Request address

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

Description:{域名地址}Replace it with your domain name, such ashttps://en.anqicms.com/attachment/upload?token={token}

Request Syntax

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

Request parameters

GET parameters

POST parameters

Return parameters

data parameter

Usage Example

Request example

curl -X POST \
  'https://en.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'

Or use the form method:

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--

Response Example

{
  "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://en.anqicms.com/uploads/202209/09/5632dd13c746a365.webp",
    "thumb": "https://en.anqicms.com/uploads/202209/09/thumb_5632dd13c746a365.webp"
  },
  "msg": ""
}

Example of error response

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

error code