API文档
返回首页
图片服务器API
本API提供图片上传、下载和浏览功能
端点列表
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
上传成功页面，包含文件详细信息
示例响应（失败）
// 状态码: 400
上传失败页面，提示"请选择图片文件"
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
支持的图片格式
- JPEG/JPG (.jpg, .jpeg)
- PNG (.png)
- GIF (.gif)
- WebP (.webp)
文件命名规则
上传的图片文件将使用ISO时间戳命名：YYYY-MM-DDTHH-MM-SS-SSSZ.ext
例如：2026-03-30T14-35-22-456Z.jpg