上传视频文件

跳转到: 导航, 搜索

接口功能

上传视频媒体文件

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格式结果。
JSON示例

{
    "code": “A0001”,
    "file_name": 201205163d07d8a2ac3173d309a26d970ef10785
}

字段说明

返回值字段 字段类型 字段说明
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为半角和全角空格

其他



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


api评价