游客上传接口,无需认证
参数:
| 参数 |
类型 |
必填 |
说明 |
file |
File |
是 |
上传的文件 |
path |
String |
否 |
存储路径,默认为 /uploads/ |
filename |
String |
否 |
自定义文件名模板 |
cURL 示例:
curl -X POST \
'https://your-site.pages.dev/api/upload' \
-F 'file=@/path/to/your/image.jpg' \
-F 'path=/images/' \
-F 'filename={timestamp}_{random}.{ext}'
JavaScript 示例:
async function uploadFile(file) {
const formData = new FormData();
formData.append('file', file);
formData.append('path', '/images/');
formData.append('filename', '{timestamp}_{random}.{ext}');
const response = await fetch('/api/upload', {
method: 'POST',
body: formData
});
return await response.json();
}
响应示例:
{
"success": true,
"data": {
"url": "https://your-site.pages.dev/file/abc123.jpg",
"path": "/uploads/abc123.jpg",
"filename": "abc123.jpg",
"size": 102400,
"type": "image/jpeg",
"uploadedAt": "2024-01-15T10:30:00Z",
"formats": {
"markdown": "",
"html": "<img src=\"https://...\">",
"bbcode": "[img]https://...[/img]"
}
}
}