rf3main/docs/guide-zh-CN/api-upload.md

文件上传

目录

• 图片上传
• 视频上传
• 语音上传
• 文件上传
• base64上传
• 获取 oss 直传配置

图片上传

请求地址(Post)

/v1/common/file/images?access-token=[access-token]

参数

参数名	参数类型	必填	默认	说明	备注
file	file	是	无	文件
drive	string	否	local	本地上传	oss:阿里云;qiniu:七牛;cos:腾讯
thumb	array	否	无	生成缩略图(具体看例子)

thumb 数组例子(生成100*100和200*200的缩略图)

{
	"thumb": [{
		"width": 100,
		"height": 100
	}, {
		"width": 200,
		"height": 200
	}]
}

返回

{
    "code": 200,
    "message": "OK",
    "data": {
        "url": "1.jpg",
    }
}

视频上传

请求地址(Post)

/v1/common/file/videos?access-token=[access-token]

参数

参数名	参数类型	必填	默认	说明	备注
file	file	是	无	文件
drive	string	否	local	本地上传	oss:阿里云;qiniu:七牛;cos:腾讯

返回

{
    "code": 200,
    "message": "OK",
    "data": {
        "url": "1.mp4",
    }
}

语音上传

请求地址(Post)

/v1/common/file/voices?access-token=[access-token]

参数

参数名	参数类型	必填	默认	说明	备注
file	file	是	无	文件
drive	string	否	local	本地上传	oss:阿里云;qiniu:七牛;cos:腾讯

返回

{
    "code": 200,
    "message": "OK",
    "data": {
        "url": "1.jpg",
    }
}

文件上传

请求地址(Post)

/v1/common/file/files?access-token=[access-token]

参数

参数名	参数类型	必填	默认	说明	备注
file	file	是	无	文件
drive	string	否	local	本地上传	oss:阿里云;qiniu:七牛;cos:腾讯

返回

{
    "code": 200,
    "message": "OK",
    "data": {
        "url": "1.jpg",
    }
}

base64上传

请求地址(Post)

/v1/common/file/base64?access-token=[access-token]

参数

参数名	参数类型	必填	默认	说明	备注
image	string	是	无	文件
drive	string	否	local	本地上传	oss:阿里云;qiniu:七牛;cos:腾讯
extend	string	否	jpg	文件后缀

返回

{
    "code": 200,
    "message": "OK",
    "data": {
        "url": "1.jpg",
    }
}

获取 oss 直传配置

请求地址(Get)

/v1/common/file/oss-accredit?access-token=[access-token]

参数

参数名	参数类型	必填	默认	说明	备注
type	string	是	无	上传类型	图片:images;文件:files;视频:videos;音频:voices

注意: 上传到 oss 的时候建议多附加几个参数

x:ip, 上传者IP
x:type, 上传类型
x:host, 返回的 host 字段
x:merchant_id, 当前商户的id

返回

{
"code": "200",
"message": "获取成功",
"data": {
    "Filename": "${filename}",
    "key": "images/2019/10/23/${filename}",
    "OSSAccessKeyId": "",
    "success_action_status": "201",
    "host": "http://file.aliyun-oss.com",
    "policy": "",
    "signature": "",
    "callback": ""
  }
}