上传文件指引

最近更新时间:2019-05-17 16:22:54

接口说明

功能说明

  1. 上传媒体(和封面)文件。
  2. API 在服务端上传位于哪个步骤请参考 服务端上传综述

SDK

建议使用 封装的 SDK 进行 API 的调用。

使用方式

使用方式可以参考以上各 API 链接中的文档,各 API 的语法为:

PUT <ObjectName> HTTP/1.1
Host: <BucketName>-<APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String

语法中的以下变量取值 VOD 申请上传的返回结果

  • <ObjectName>MediaStoragePath(对于封面文件为 CoverStoragePath)。
  • <BucketName>-<APPID>StorageBucket
  • <Region>StorageRegion

对于 API 请求需要注意下面两点:

  1. Authorization 签名使用 VOD 申请上传返回结果TempCertificate 的 SecretId 和 SecretKey,请参见 签名文档 指引进行计算。
  2. 在 HTTP 头部或 POST 请求包的 form-data 中传入 x-cos-security-token 字段标识该请求使用的安全令牌,并赋值为 TempCertificate 的 Token 字段。