2/kandian/视频转码后的回调接口

跳转到: 导航, 搜索
(以“{{kandian_api_upload_callback_desc| httpMethod=POST| needAuth=是| level={{Api_L1}}| rateLimit=是| params={{api_args|file|true|string|视频文件,文件大小不...”为内容创建页面)
 
 
第1行: 第1行:
 
{{kandian_api_upload_callback_desc|
 
{{kandian_api_upload_callback_desc|
 
httpMethod=POST|
 
httpMethod=POST|
needAuth=|
+
params={{api_args|vid|true|int|视频vid。}}
level={{Api_L1}}|
+
{{api_args|code|true|string|“A0001”:成功;“A0002”: 对不起,您的帐号曾违反新浪上传视频条款,已被禁止进行视频上传操作;“A0003”: 因违反新浪视频相关条款,已被删除;“A0004”:转码失败。}}
rateLimit=是|
+
{{api_args|error|false|stirng|失败原因,失败才有。}}
params={{api_args|file|true|string|视频文件,文件大小不能超过1G。}}
+
{{api_args|epg_id|false|int|转码成功后视频的epg_id,成功才有。}}
 
|
 
|
resultDes=如果请求的url中有redirecturl参数,上传文件之后将用户浏览器重定向到redirecturl指定的地址,并带get方式的参数:“?code=&error=&file_name=”;如果请求的url不带redirecturl参数,则返回json格式结果。|
 
 
result=
 
result=
 
<pre>
 
<pre>
 
{
 
{
     "code": “A0001”,
+
     "code":”A0001”
    "file_name": 201205163d07d8a2ac3173d309a26d970ef10785
+
 
}
 
}
 
</pre>|
 
</pre>|
fieldInterpre={{Rdes_cgiBin_upload}}|
+
fieldInterpre={{rdes_args|code|string|返回码,”A0001”表示成功}}
 +
|
 
resultError=
 
resultError=
 
<pre>
 
<pre>
 
{
 
{
 
     "code":”A0002”,
 
     "code":”A0002”,
     "error": "upload failed",
+
     "error": " param error, missed vid"
    "file_name": 201205163d07d8a2ac3173d309a26d970ef10785
+
 
}
 
}
 
</pre>|
 
</pre>|
第26行: 第24行:
 
  <tr>
 
  <tr>
 
     <td {{Table_css}}>A0002</td>
 
     <td {{Table_css}}>A0002</td>
     <td {{Table_css}}>upload failed</td>
+
     <td {{Table_css}}>param error,***</td>
     <td {{Table_css}}>上传失败</td>
+
     <td {{Table_css}}>参数错误,后跟具体哪个参数什么错误</td>
 
  </tr>
 
  </tr>
 
  <tr>
 
  <tr>
 
     <td {{Table_css}}>A0003</td>
 
     <td {{Table_css}}>A0003</td>
     <td {{Table_css}}>auth failed</td>
+
     <td {{Table_css}}>system error</td>
    <td {{Table_css}}>无权限,ssig验证不通过</td>
+
     <td {{Table_css}}>第三方内部系统错误</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>
 
  </tr>
 
|
 
|

2012年8月22日 (三) 15:15的最后版本

接口功能

应用需提供的回调接口,供对媒资文件管理操作完成后的回调。

URL

https://api.weibo.com/2/kandian/upload/upload_info.json 参数中的callbackurl。

支持格式

JSON

HTTP请求方式

POST

请求参数

  必选 类型及范围 说明
vid true int 视频vid。
code true string “A0001”:成功;“A0002”: 对不起,您的帐号曾违反新浪上传视频条款,已被禁止进行视频上传操作;“A0003”: 因违反新浪视频相关条款,已被删除;“A0004”:转码失败。
error false stirng 失败原因,失败才有。
epg_id false int 转码成功后视频的epg_id,成功才有。

注意事项

返回结果

JSON示例

{
    "code":”A0001”
}

字段说明

返回值字段 字段类型 字段说明
code string 返回码,”A0001”表示成功

错误返回值格式

JSON示例

{
    "code":”A0002”,
    "error": " param error, missed vid"
}

错误代码对照表

错误代码 错误信息 详细描述
A0002 param error,*** 参数错误,后跟具体哪个参数什么错误
A0003 system error 第三方内部系统错误

其他




文档更新时间: 2012-08-22
api评价