拖拽文件到此处或点击选择
支持的文件格式
最大文件大小: 10MB
上传结果
API文档
正在上传文件，请稍候...
已上传的图片
📚 API 使用文档
🔗 接口地址
POST
https://upload.gison.dpdns.org/upload.php
📝 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file | File | 是 | 要上传的文件 |
| type | String | 否 | 文件分类：common/product/avatar/document/temp |
📤 请求示例
curl -X POST https://upload.gison.dpdns.org/upload.php \
-F "file=@example.png" \
-F "type=common"
📥 响应格式
成功响应 (code: 200):
{
"code": 200,
"message": "上传成功",
"data": {
"originalName": "example.png",
"fileName": "685fa7dd671d7_1751099357.png",
"fileSize": 102400,
"fileType": "image/png",
"category": "common",
"relativePath": "common/2025/06/685fa7dd671d7_1751099357.png",
"accessUrl": "https://upload.gison.dpdns.org/common/2025/06/685fa7dd671d7_1751099357.png",
"uploadTime": "2025-01-06T10:30:00Z"
}
}
失败响应 (code: 400/500):
{
"code": 400,
"message": "文件类型不支持",
"data": null
}
🖼️ 资源访问示例
# 图片访问地址格式
https://upload.gison.dpdns.org/common/2025/06/685fa7dd671d7_1751099357.png
# 其他文件访问地址格式
https://upload.gison.dpdns.org/document/2025/06/filename.pdf
https://upload.gison.dpdns.org/avatar/2025/06/avatar.jpg
⚠️ 注意事项
- 支持的文件格式：JPG, PNG, GIF, WEBP, PDF, DOC, XLS, PPT, TXT, JSON等
- 单个文件最大大小：10MB
- 文件会按照分类和日期自动组织目录结构
- 文件名会自动生成唯一标识，避免重复
- 上传成功后返回的accessUrl可直接用于访问文件
🔧 JavaScript 调用示例
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('type', 'common');
fetch('https://upload.gison.dpdns.org/upload.php', {
method: 'POST',
body: formData
})
.then(response => response.json())
.then(data => {
if (data.code === 200) {
console.log('上传成功:', data.data.accessUrl);
} else {
console.error('上传失败:', data.message);
}
})
.catch(error => {
console.error('请求错误:', error);
});