OPPO开放平台API传包能力接入 文件上传

请求 upload_url,参数为 文件上传 接口列出的参数,sign 是一次性的,每上传一个文件都需要重新获取一次。

OPPO开放平台API传包能力接入 文件上传

上传流程说明

1)请求 获取上传配置 接口实时获取上传的请求 URL 和 sign。

2)请求 upload_url,参数为 文件上传 接口列出的参数,sign 是一次性的,每上传一个文件都需要重新获取一次。

获取上传配置

接口功能

此接口用于获取上传文件配置。

接口原型

-请求路由:/resource/v1/upload/get-upload-url
-请求方法:GET
-请求类型:Content-Type: x-www-form-urlencoded

请求参数

只需传入公共参数。

请求响应

响应说明

字段类型说明
errnoint错误码,为 0 表示请求成功
dataPreUploadBody响应结果,结构参考 PreUploadBody

PreUploadBody

字段类型说明
upload_urlstring文件上传 URL
signstring一次性标识,单次有效,每个新文件必须重新获取

响应示例

成功示例
{
    "errno": 0,
    "data": {
        "upload_url": "https://oppo.com/xxxxxxxxx",
        "sign": "b1fe****ad13"
    }
}

文件上传

接口功能

此接口用于上传文件。

接口原型

  • 请求 URL:接口获取上传配置返回的 upload_url
  • 请求方法:POST
  • 请求类型:Content-Type: multipart/form-data

请求参数

字段类型是否必传说明
typestring文件类型,包括照片、APK 包、其它,值是:photo、apk、resource
signstring一次性标识,从获取上传配置返回的 sign 字段,单次有效,每个新文件必须重新获取
filebinary文件对象

请求响应

响应说明

字段类型说明
errnoint错误码,为 0 表示请求成功
datamap响应结果,参考 UploadObj

UploadObj

字段类型说明
urlstring文件地址(带域名)
uri_pathstring文件 URI(不带域名)
md5string文件 MD5
file_extensionstring文件扩展名
file_sizeint文件大小
idstring标记
widthint图片宽度(只有图片才有)
heightint图片高度(只有图片才有)

响应示例

成功示例

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": []
    }
}

编辑:yimen,如若转载,请注明出处:https://www.yimenapp.com/kb-yimen/10840/

部分内容来自网络投稿,如有侵权联系立删

(0)
上一篇 2022年11月17日 下午5:08
下一篇 2022年11月17日 下午5:12

相关推荐