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"}
fail:
{"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}
