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

discovery

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

请求参数

参数名是否必须类型参数说明
uidYLong上传用户ID
statusNString网络环境
typeYString上传文件类型, 'video';'pic';'image'
sizeYLong上传文件大小, 单位B

请求HEADER参数

参数名是否必须类型参数说明
UANString客户端型号

返回结果

  • 类型:json
  • 返回值:
key类型说明
init_urlString根据上传类型分配的init地址
upload_urlString根据上传类型分配的upload地址
check_urlString根据上传类型分配的check地址
bypassStringbypass类型
  • 示例:

    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

请求参数

参数名是否必须类型参数说明
typeYString上传文件类型, 'video';'pic';'image'
checkYString上传文件MD5
lengthYLong上传文件大小
nameYString上传文件名称
createtypeNString上传文件来源, 拍摄上传: 'shooting'; 本地文件上传:'localfile'
uidYLong上传用户ID
statusNString网络环境

请求HEADER参数

参数名是否必须类型参数说明
UANString客户端型号

返回结果

  • 类型:json
  • 返回值:
key类型说明
urlTagString“1”, 兼容旧协议保留
fileTokenString分配的uploadId
lengthLong分配的分片大小, 单位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

请求参数

参数名是否必须类型参数说明
uidYLong上传用户ID
statusNString网络环境
filetokenYStringinit分配的上传ID
startlocYLong分片在文件中的起始字节k
sectioncheckYString分片MD5

返回结果

  • 类型:json
  • 返回值:
key类型说明
succString分片上传结果:"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

请求参数

参数名是否必须类型参数说明
typeYString上传文件类型, 'video';'pic';'image'
checkYString上传文件MD5
lengthYLong上传文件大小
nameYString上传文件名称
createtypeNString上传文件来源, 拍摄上传: 'shooting'; 本地文件上传:'localfile'
uidYLong上传用户ID
statusNString网络环境
filetokenYString初始化返回的filetoken

请求HEADER参数

参数名是否必须类型参数说明
UANString客户端型号

返回结果

  • 类型:json
  • 返回值:
key类型说明
urlTagString“1”, 兼容旧协议保留
fileTokenString分配的uploadId
lengthLong分配的分片大小, 单位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}

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

echo爱学易语言

你的鼓励,我的动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值