Cgi-bin/upload
(以“{{kandian_api_upload_desc| uri=kandian/tv/program| desc=根据电视台id和时间获取看点电视台的节目列表| httpMethod=GET| needAuth=是| level={{Api_L1}...”为内容创建页面) |
|||
| （未显示1个用户的3个中间版本） | |||
| 第1行： | 第1行： | ||
{{kandian_api_upload_desc| | {{kandian_api_upload_desc| | ||
| − | + | httpMethod=POST| | |
| − | + | ||
| − | httpMethod= | + | |
needAuth=是| | needAuth=是| | ||
level={{Api_L1}}| | level={{Api_L1}}| | ||
rateLimit=是| | rateLimit=是| | ||
| − | params={{api_args| | + | params={{api_args|file|true|string|视频文件，文件大小不能超过1G。}} |
| − | + | | | |
| − | + | resultDes=如果请求的url中有redirecturl参数，上传文件之后将用户浏览器重定向到redirecturl指定的地址，并带get方式的参数：“?code=&error=&file_name=”；如果请求的url不带redirecturl参数，则返回json格式结果。| | |
result= | result= | ||
<pre> | <pre> | ||
{ | { | ||
| − | " | + | "code": “A0001”, |
| − | " | + | "file_name": 201205163d07d8a2ac3173d309a26d970ef10785 |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
} | } | ||
</pre>| | </pre>| | ||
| − | + | fieldInterpre={{Rdes_cgiBin_upload}}| | |
| + | resultError= | ||
| + | <pre> | ||
| + | { | ||
| + | "code":”A0002”, | ||
| + | "error": "upload failed", | ||
| + | "file_name": 201205163d07d8a2ac3173d309a26d970ef10785 | ||
| + | } | ||
| + | </pre>| | ||
| + | errorInterpre= | ||
| + | <tr> | ||
| + | <td {{Table_css}}>A0002</td> | ||
| + | <td {{Table_css}}>upload failed</td> | ||
| + | <td {{Table_css}}>上传失败</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td {{Table_css}}>A0003</td> | ||
| + | <td {{Table_css}}>auth failed</td> | ||
| + | <td {{Table_css}}>无权限,ssig验证不通过</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td {{Table_css}}>A0004</td> | ||
| + | <td {{Table_css}}>the video file is larger than 1G</td> | ||
| + | <td {{Table_css}}>文件大小超过1G</td> | ||
| + | </tr> | ||
| + | <tr> | ||
| + | <td {{Table_css}}>A0005</td> | ||
| + | <td {{Table_css}}>parameter error</td> | ||
| + | <td {{Table_css}}>uid，ip，filename,ssig为空，或者filename为半角和全角空格 | ||
| + | </td> | ||
| + | </tr> | ||
| + | | | ||
useAge=*无| | useAge=*无| | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} | ||
2012年8月22日 (三) 11:55的最后版本
接口功能
上传视频媒体文件
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为半角和全角空格 |
其他
无
文档更新时间: 2012-08-22
