POST
/upload
上传图片文件
参数：
image (文件): 图片文件（支持JPG、PNG、GIF、WebP格式）
示例请求（表单提交）
<form action="/upload" method="post" enctype="multipart/form-data">
<input type="file" name="image" accept="image/*">
<button type="submit">上传</button>
</form>
示例请求（Python）
import requests
server_url = 'http://your-server-domain.com'
url = f'{server_url}/upload'
files = {'image': open('example.jpg', 'rb')}
response = requests.post(url, files=files)
print(response.status_code)
print(response.text)
示例响应（成功）
// 状态码: 200
{
"success": true,
"message": "图片已成功上传！",
"file": {
"originalname": "example.jpg",
"filename": "example.jpg",
"size": 10240,
"mimetype": "image/jpeg",
"url": "/uploads/example.jpg"
}
}
示例响应（失败）
// 状态码: 400
{
"success": false,
"error": "请选择图片文件"
}
GET
/images
获取所有图片列表（JSON格式）
示例请求（Python）
import requests
server_url = 'http://your-server-domain.com'
url = f'{server_url}/images'
response = requests.get(url)
if response.status_code == 200:
images = response.json()
print(images)
else:
print(f'Error: {response.status_code}')
示例响应（成功）
// 状态码: 200
[
{
"filename": "2026-03-30T14-35-22-456Z.jpg",
"originalname": "example.jpg",
"size": 10240,
"createdAt": "2026-03-30T14:35:22.456Z"
}
]
示例响应（失败）
// 状态码: 500
{"error": "Failed to read directory"}
GET
/uploads/:filename
下载指定图片文件
示例请求（Python）
import requests
server_url = 'http://your-server-domain.com'
filename = '2026-03-30T14-35-22-456Z.jpg'
url = f'{server_url}/uploads/{filename}'
response = requests.get(url)
if response.status_code == 200:
with open('downloaded.jpg', 'wb') as f:
f.write(response.content)
print('Image downloaded successfully')
else:
print(f'Error: {response.status_code}')
示例响应（成功）
// 状态码: 200
图片文件（二进制数据）
示例响应（失败）
// 状态码: 404
Cannot GET /uploads/nonexistent.jpg