# 功能描述
获取上传云存储的 accessKeyId
secretAccessKey
securityToken
等。
# 请求
# 请求示例
GET upload/sts/info HTTPS
Host: <host>
Content-Type: application/json
Authorization: <AuthString>
# 请求头
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
Authorization | 用户token信息 | string | 是 |
# 请求参数
无
# 请求体
{
"type":3,
"extension":"json",
"isNeedCallback":1,
"uploadModule":"bs_project",
"projectId":8357,
"isDir":1,
"uuid":"",
"platform": "web"
}
字段说明
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
type | 类型 - 0:七牛云 - 1: 腾讯云 - 2:亚马逊 - 3:阿里云 - 4:百度云 - 6:华为云 - 7:金山云 目前只支持阿里云、七牛云、华为云、亚马逊、金山云 | int | 是 |
extension | 上传的文件的扩展名 | String | 是 |
isNeedCallback | 分片上传需要回调 0否1是 当前工程相关的资源不需要回调 | int | 是 |
uploadModule | 上传的模块 bs工程 bs_project app工程 app_project 视频 resource_video 图片 resource_image 音频 resource_audio 模板 material_template 临时目录 temp | String | 是 |
platform | 上传的设备 web端:web app端:app 默认是app | String | 否 |
projectId | 上传的模块是bs工程时,需要携带工程id | Long | 否 |
isDir | 是否为序列本 0否1是 | int | 否 |
uuid | 模板的uuid | String | 上传模板时需要这个参数 |
# 响应
# 响应头
此接口无特殊响应头。
#
# 响应体
请求成功的响应体为
{
"code": 0,
"message": "",
"data": {
"accessKeyId": ".....",
"secretAccessKey": ".....",
"securityToken": "....",
"bucket": "bseditor",
"endpoint": "http://oss-cn-beijing.aliyuncs.com",
"relativePath": "test/resource/video/2020/12/25/10503/0df00d20-5e55-4914-95f0-e02ff0abbfb8.mp4",
"expiration": "2020-12-26T01:05:02Z",
"region": "oss-cn-beijing",
"objectId": 10503,
// 这个回调只针对于用阿里云上传时使用分片上传的情况。
// 因为分片上传到云端后,需要阿里云进行合成,这个合成会有一定时间,有可能在前端发起resource/create的时候,还没有合成完成,实现该回调用来监测阿里云合成是否完成。
// 如果完成的话,才会在服务端继续调用job/create
// 详见:https://help.aliyun.com/document_detail/64047.html?spm=a2c4g.11186623.6.1219.527e23f2SoLNwR
"callbackInfo": {
"callbackBodyType": "application/x-www-form-urlencoded",
"callbackUrl": "http://localhost:8088/upload/callback",
"customInfo": {
"objectId": 10503,
"resourceType": 1
},
"callbackBody": "objectId=${x:objectId}&resourceType=${x:resourceType}"
},
//金山云上传凭证的signature
"signature":"......",
//金山云上传凭证的policy
"policy":"......"
}
}
名称 | 描述 | 类型 | 必填 |
---|---|---|---|
accessKeyId | 云存储的accessKey | string | 是 |
secretAccessKey | 云存储的secretKey | string | 是 |
securityToken | 云存储的securityToken | string | 是 |
bucket | 云存储的存储桶名称 | string | 是 |
endpoint | 云存储的地域节点host | string | 是 |
relativePath | 上传到云存储文件的key | string | 是 |
expiration | key的过期时间 | string | 是 |
region | 存储的地域名称 | string | 是 |
objectId | 返回的资源id, resource/create 接口中需要携带该参数 | long | 是 |
callbackInfo | 回调时携带的信息 | 对象 | 否 |
callbackBodyType | 回调时的content-type | String | 否 |
callbackUrl | 回调的url | String | 否 |
customInfo | 回调携带的自定的参数 | 对象 | 否 |
callbackBody | 回调的请求体 | String | 否 |
signature | 金山云上传凭证的signature | string | 否 |
policy | 金山云上传凭证的policy | string | 否 |
请求失败的响应体为
{
"code": <errorCode>,
"enMsg": <errorMessage>,
"msg": <errorMessage>,
"data": null
}
# 示例
以七牛云存储为例:
← 上传文件到本地服务器 创建资源 →