C/2/multimedia/upload
(以“{{Api_desc_business| uri=multimedia/upload| desc=用来进行分片上传。其中,filetoken、chunksize由init接口的返回值确定。在分片上传过程中...”为内容创建页面) |
|||
第31行: | 第31行: | ||
</pre>| | </pre>| | ||
resultDes=无| | resultDes=无| | ||
− | useAge= | + | useAge=* 文件数据加到请求body体里 |
+ | * 前面的分片按init返回的length值进行传递,最后一片有多少传多少| | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} |
2018年1月23日 (二) 14:43的最后版本
multimedia/upload
用来进行分片上传。其中,filetoken、chunksize由init接口的返回值确定。在分片上传过程中,根据源文件大小计算出总共需要分几次上传,再依次调用upload接口进行上传。期间,可以通过check接口检查哪些分片已经上传成功,哪些还未上传。
URL
https://c.api.weibo.com/2/multimedia/upload.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 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" }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无
文档更新时间: 2018-01-23