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 |
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 |
UploadObj
| 字段 | 类型 | 说明 |
|---|---|---|
| url | string | 文件地址（带域名） |
| uri_path | string | 文件 URI（不带域名） |
| md5 | string | 文件 MD5 |
| file_extension | string | 文件扩展名 |
| file_size | int | 文件大小 |
| id | string | 标记 |
| width | int | 图片宽度（只有图片才有） |
| height | int | 图片高度（只有图片才有） |
响应示例
成功示例
APK 类型
{
"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
}
}
resource
{
"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": []
}
}