Cgi-bin/upload
接口功能
上传视频媒体文件
URL
示例
http://aaa&redirecturl=http://bbb
说明
本接口由两个部分组成:
1. “http://aaa” 是调用 2/kandian/upload/get_url 接口返回数据中的“url”字段。
2. redirecturl 参数可选,指的是应用页面重定向的地址。如果不添加该参数,返回结果为json格式的数据。
该参数需要进行urlencode,字符长度为浏览器地址栏的限定长度。
如果用户在浏览器中通过表单方式上传视频文件,建议添加此参数。
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:普通接口
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
file | true | string | 视频文件,文件大小不能超过1G。 |
注意事项
- 无
返回结果
如果请求的url中有redirecturl参数,上传文件之后将用户浏览器重定向到redirecturl指定的地址,并带get方式的参数:“?code=&error=&file_name=”;如果请求的url不带redirecturl参数,则返回json格式结果。
result=
{ "code": “A0001”, "file_name": 201205163d07d8a2ac3173d309a26d970ef10785 }
JSON示例
{{{result}}}
字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
code | string | 返回码,”A0001”表示成功 |
file_name | string | https://api.weibo.com/2/kandian/upload/get_url.json 返回的file_name |
错误返回值格式
JSON示例
{ "code":”A0002”, "error": "upload failed", "file_name": 201205163d07d8a2ac3173d309a26d970ef10785 }
错误代码对照表
错误代码 | 错误信息 | 详细描述 |
A0002 | upload failed | 上传失败 |
A0003 | auth failed | 无权限,ssig验证不通过 |
A0004 | the video file is larger than 1G | 文件大小超过1G |
A0005 | parameter error | uid,ip,filename,ssig为空,或者filename为半角和全
角空格 |
其他
无