OPPO开放平台API传包能力接入 文件上传
1)请求 获取上传配置 接口实时获取上传的请求 URL 和 sign。
2)请求 upload_url,参数为 文件上传 接口列出的参数,sign 是一次性的,每上传一个文件都需要重新获取一次。
此接口用于获取上传文件配置。
-请求路由:/resource/v1/upload/get-upload-url
-请求方法:GET
-请求类型:Content-Type: x-www-form-urlencoded
只需传入公共参数。
字段 | 类型 | 说明 |
---|
errno | int | 错误码,为 0 表示请求成功 |
data | PreUploadBody | 响应结果,结构参考 PreUploadBody |
字段 | 类型 | 说明 |
---|
upload_url | string | 文件上传 URL |
sign | string | 一次性标识,单次有效,每个新文件必须重新获取 |
{
"errno": 0,
"data": {
"upload_url": "https://oppo.com/xxxxxxxxx",
"sign": "b1fe****ad13"
}
}
此接口用于上传文件。
- 请求 URL:接口获取上传配置返回的
upload_url
- 请求方法:POST
- 请求类型:
Content-Type: multipart/form-data
字段 | 类型 | 是否必传 | 说明 |
---|
type | string | 是 | 文件类型,包括照片、APK 包、其它,值是:photo、apk、resource |
sign | string | 是 | 一次性标识,从获取上传配置返回的 sign 字段,单次有效,每个新文件必须重新获取 |
file | binary | 是 | 文件对象 |
字段 | 类型 | 说明 |
---|
errno | int | 错误码,为 0 表示请求成功 |
data | map | 响应结果,参考 UploadObj |
字段 | 类型 | 说明 |
---|
url | string | 文件地址(带域名) |
uri_path | string | 文件 URI(不带域名) |
md5 | string | 文件 MD5 |
file_extension | string | 文件扩展名 |
file_size | int | 文件大小 |
id | string | 标记 |
width | int | 图片宽度(只有图片才有) |
height | int | 图片高度(只有图片才有) |
{
"errno": 0,
"data": {
"url": "https://oppo.com/********261d.apk",
"uri_path": "/********261d.apk",
"md5": "5efd****4d4d",
"file_extension": "apk",
"file_size": 4181241,
"id": "XXXXX"
}
}
{
"errno": 0,
"data": {
"url": "http://oppo.com/********d47d.jpg",
"uri_path": "/********d47d.jpg",
"md5": "55e3****1084",
"sign": "eee4****bce4",
"width": 1080,
"height": 1920,
"file_extension": "jpg",
"file_size": 598879
}
}
{
"errno": 0,
"data": {
"url": "http://oppo.com/********a936.pdf",
"uri_path": "/********a936.pdf",
"md5": "d557****4931",
"sign": "b384****821f",
"file_extension": "pdf",
"file_size": 15106
}
}
-sign 过期或不合法,需要重新调用接口获取 sign
{
"errno": 910003,
"data": {
"message": "Unauthorized upload [1]",
"logid": 2965369111,
"ext": []
}
}