Skip to content

1 上传文件 ​

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

兼容入口: /merchantapi/user/user/upload(同样读取 file 和 type,推荐优先使用上面的统一上传入口)

请求方式: 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 格式的表单