微博原生视频统一文件服务接口文档

discovery

接口说明：统一文件服务根据上传类型分配初始化init、上传upload、重试check接口及bypass属性
接口地址：
http://i.multimedia.api.weibo.com/2/multimedia/discovery.json

请求参数：

参数名	是否必须	类型	参数说明
uid	Y	Long	上传用户ID
status	N	String	网络环境
type	Y	String	上传文件类型， 'video';'pic';'image'
size	Y	Long	上传文件大小， 单位B

请求HEADER参数：

参数名	是否必须	类型	参数说明
UA	N	String	客户端型号

返回结果：

• 类型：json
• 返回值：

key	类型	说明
init_url	String	根据上传类型分配的init地址
upload_url	String	根据上传类型分配的upload地址
check_url	String	根据上传类型分配的check地址
bypass	String	bypass类型

• 示例：

  succ:

  {"init_url":"http://multimedia.api.weibo.com/2/multimedia/init.json","upload_url":"http://multimedia.api.weibo.com/2/multimedia/upload.json","check_url":"http://multimedia.api.weibo.com/2/multimedia/check.json","bypass":"multimedia.video"}

  
   

  {"error":"miss required parameter (zise), see doc for more info.","error_code":10016,"request":"/2/multimedia/discovery.json","http_code":400}

   

init 上传初始化

接口说明： 通过上传文件信息换取分配的上传ID以及分片大小
接口地址：
http://i.multimedia.api.weibo.com/2/multimedia/init.json

请求参数：

参数名	是否必须	类型	参数说明
type	Y	String	上传文件类型， 'video';'pic';'image'
check	Y	String	上传文件MD5
length	Y	Long	上传文件大小
name	Y	String	上传文件名称
createtype	N	String	上传文件来源， 拍摄上传: 'shooting'; 本地文件上传：'localfile'
uid	Y	Long	上传用户ID
status	N	String	网络环境

请求HEADER参数：

参数名	是否必须	类型	参数说明
UA	N	String	客户端型号

返回结果：

• 类型：json
• 返回值：

key	类型	说明
urlTag	String	“1”， 兼容旧协议保留
fileToken	String	分配的uploadId
length	Long	分配的分片大小， 单位KB

• 示例：

succ:

  {"urlTag":"1","fileToken":"1408178459.447.fff3b5d66e54fa4c2bdf43f8348d5.r11833","length":64} 

fail:

   {"error":"miss required parameter (name), see doc for more info.","error_code":10016,"request":"/2/multimedia/init.json","http_code":400} 

upload分片上传

接口说明：根据init分配的filetoken和分片大小， 分片上传文件，文件上传完整后， 自动进行合并、转码、发微博操作
接口地址：
http://i.multimedia.api.weibo.com/2/multimedia/upload.json

请求参数：

参数名	是否必须	类型	参数说明
uid	Y	Long	上传用户ID
status	N	String	网络环境
filetoken	Y	String	init分配的上传ID
startloc	Y	Long	分片在文件中的起始字节k
sectioncheck	Y	String	分片MD5

返回结果：

• 类型：json
• 返回值：

key	类型	说明
succ	String	分片上传结果："true"

• 示例：
  succ

{"succ":"true"}

fail

{"error":"save file error!","error_code":20017,"request":"/2/multimedia/upload.json","http_code":400}

check重试接口

接口说明：上传暂停后，重传分片前， 发起重试请求，获取当前分配的filetoken和分片大小。上传数据未过期情况下，该返回与本次上传init的返回一致， 否则， 为重新分配。
接口地址：
http://i.multimedia.api.weibo.com/2/multimedia/check.json

请求参数：

参数名	是否必须	类型	参数说明
type	Y	String	上传文件类型， 'video';'pic';'image'
check	Y	String	上传文件MD5
length	Y	Long	上传文件大小
name	Y	String	上传文件名称
createtype	N	String	上传文件来源， 拍摄上传: 'shooting'; 本地文件上传：'localfile'
uid	Y	Long	上传用户ID
status	N	String	网络环境
filetoken	Y	String	初始化返回的filetoken

请求HEADER参数：

参数名	是否必须	类型	参数说明
UA	N	String	客户端型号

返回结果：

• 类型：json
• 返回值：

key	类型	说明
urlTag	String	“1”， 兼容旧协议保留
fileToken	String	分配的uploadId
length	Long	分配的分片大小， 单位KB

• 示例：
  succ:

{"urlTag":"1","fileToken":"1408178459.447.fff3b5d66e54fa4c2bdf43f8348d5.r11833","length":64}

fail:

{"error":"miss required parameter (name), see doc for more info.","error_code":10016,"request":"/2/multimedia/init.json","http_code":400}