Skip to content

1 上传文件

接口地址: /merchantapi/user/upload/upload

请求方式: POST

请求参数:

参数名类型必填说明
filefile上传的文件
typestring文件类型: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 格式的表单