C/2/multimedia/upload

跳转到: 导航, 搜索

multimedia/upload

用来进行分片上传。其中,filetoken、chunksize由init接口的返回值确定。在分片上传过程中,根据源文件大小计算出总共需要分几次上传,再依次调用upload接口进行上传。期间,可以通过check接口检查哪些分片已经上传成功,哪些还未上传。

URL

https://c.api.weibo.com/2/multimedia/upload.json

支持格式

JSON

HTTP请求方式

POST

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制


请求所有商业接口:

    • 50000次/小时/IP;

请求参数

  必选 类型及范围 说明
source false string 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。
access_token false string 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。
filetoken true String 初始化时返回的file token值
sectioncheck true String 分片文件MD5校验值
startloc true Long 分片起始位置
filelength true Long 源文件大小
check true String 文件MD5校验值
chunksize false Long 当前分片大小
ua false String 设备信息
client false String 设备类型(web/iphone/android/other)
type false String 业务类型(默认为video)
status false String 网络环境(2g/3g/4g/wifi/wired/unknown)
chunkcount false Integer 文件总片数
chunkindex false Integer 当前分片序号(从0开始计算)

注意事项

  • 文件数据加到请求body体里
  • 前面的分片按init返回的length值进行传递,最后一片有多少传多少

返回结果

JSON示例

//分片上传成功,整个文件尚未上传完成
{
    "succ":true
}

//分片上传成功,所有分片已全部上传
{
    "fid":"1234567890"
}

关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他



Language: [[{{{2/uri}}}|中文]]


api评价