1 上传文件
接口地址: /merchantapi/user/upload/upload
请求方式: POST
请求参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file | file | 是 | 上传的文件 |
| type | string | 否 | 文件类型:image=图片,video=视频,file=文件(默认image) |
响应示例:
json
{
"code": 1,
"msg": "上传成功",
"data": "https://example.com/uploads/2023/12/01/abc123.jpg"
}业务规则:
- 图片格式:jpg、jpeg、png、gif、webp
- 视频格式:mp4、avi、mov、wmv
- 上传文件大小受到defaultMaxPackageSize限制,默认10M,可在config/server.php文件中修改max_package_size更改默认值。
- 文件名自动重命名为唯一标识
- 返回完整的文件访问URL
错误示例:
json
{
"code": 0,
"msg": "请选择文件",
}
{
"code": 0,
"msg": "文件格式错误",
}
{
"code": 0,
"msg": "文件类型不允许",
}
{
"code": 0,
"msg": "存储方式错误!请到系统设置里存储配置进行设置",
}注意事项
- 后端对文件有验证,但建议前端验证页做上
- 文件上传后会自动重命名为唯一标识,并返回文件访问的绝对URL
- 上传文件需要使用 multipart/form-data 格式的表单