帮助中心 HELP CENTER

上传视频接口

 

接口URL

http://v.polyv.net/uc/services/rest?method=uploadfile 

接口说明

作用:上传本地视频 

支持格式

JSON 

请求方式

POST 

请求数限制

TRUE 

请求参数

参数名 必选 类型及范围 说明
writetoken true string 用户的上传钥匙
JSONRPC true string json格式,{"title": "标题", "tag":"标签","desc":"描述"}
Filedata true file file类型,支持的文件格式为:.flv,.avi,.mpg,.mp4,.wmv,.mov,.3gp,.asf等
fcharset flase string 当fcharset设为'ISO-8859-1'时,可以避免视频的文件名乱码
cataid false long 设定上传视频的分类,分类的id可以在“视频管理”——“内容分类”中获取,如下图所示。cataid为catatree的最后一个long型的整数,catatree由cataid组成。当cataid值为1时,表示用户上传空间的根目录。
watermark false string 水印图片的URL,图片格式必须是png格式
luping false int 是否录屏优化。当值为1时,上传的视频不再采取默认的压缩编码机制,视频尺寸不再压缩,保证视频的清晰度。默认值为0
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})
fileMd5 false string 文件校验码,为32位大写MD5的值

注意事项

上传视频接口POST不能携带cookie 返回错误列表 
返回 说明
0 无错误
1 找不到writetoken关联的user
2 文件为空或者writetoken为空
3 提交的json名字JSONRPC为null
4 提交文件格式不正确
5 readtoken为空
6 分页输入出错
7 vid不能为空
8 找不到方法名
14 文件md5校验失败
15 后台处理出错
16 用户的可用空间已用完

返回结果

  1. <xml> 
  2. <error>0</error> 
  3. <total/> 
  4. <data> 
  5. <video> 
  6. <md5checksum> 
  7. <![CDATA[ 44b145c6bea7dd826191990dfb38d1fd ]]> 
  8. </md5checksum> 
  9. <tag> 
  10. <![CDATA[ 标签 ]]> 
  11. </tag> 
  12. <mp4> 
  13. <![CDATA[http://mpv.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_1.mp4]]> 
  14. </mp4> 
  15. <title> 
  16. <![CDATA[ upload上传视频 ]]> 
  17. </title> 
  18. <df>2</df> 
  19. <times> 
  20. <![CDATA[ 0 ]]> 
  21. </times> 
  22. <mp4_1> 
  23. <![CDATA[http://mpv.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_1.mp4]]> 
  24. </mp4_1> 
  25. <vid> 
  26. <![CDATA[ 36e77ba39cc4768ab541cb6bf4f775a0_3 ]]> 
  27. </vid> 
  28. <mp4_2> 
  29. <![CDATA[http://mpv.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_2.mp4]]> 
  30. </mp4_2> 
  31. <cataid> 
  32. <![CDATA[ 1 ]]> 
  33. </cataid> 
  34. <swf_link> 
  35. <![CDATA[http://player.polyv.net/videos/36e77ba39cc4768ab541cb6bf4f775a0_3.swf]]> 
  36. </swf_link> 
  37. <status> 
  38. <![CDATA[ 10 ]]> 
  39. </status> 
  40. <seed>1</seed> 
  41. <flv2> 
  42. <![CDATA[http://plvod01.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_2.flv]]> 
  43. </flv2> 
  44. <flv1> 
  45. <![CDATA[http://plvod01.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_1.flv]]> 
  46. </flv1> 
  47. <sourcefile> 
  48. <![CDATA[ ]]> 
  49. </sourcefile> 
  50. <playerwidth> 
  51. <![CDATA[ 600 ]]> 
  52. </playerwidth> 
  53. <hls/> 
  54. <default_video> 
  55. <![CDATA[http://plvod01.videocc.net/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_1.flv]]> 
  56. </default_video> 
  57. <duration> 
  58. <![CDATA[ 00:00:33 ]]> 
  59. </duration> 
  60. <filesize/> 
  61. <first_image> 
  62. <![CDATA[http://img.videocc.net/uimage/3/36e77ba39c/0/36e77ba39cc4768ab541cb6bf4f775a0_0.jpg]]> 
  63. </first_image> 
  64. <original_definition> 
  65. <![CDATA[ 672x378 ]]> 
  66. </original_definition> 
  67. <context> 
  68. <![CDATA[ 视频文档描述 ]]> 
  69. </context> 
  70. <previewVid> 
  71. <![CDATA[ m63c44pl69mm7435lp871mp3pn7n448l0_6 ]]> 
  72. </previewVid> 
  73. <playerheight> 
  74. <![CDATA[ 490 ]]> 
  75. </playerheight> 
  76. <ptime> 
  77. <![CDATA[ 2017-12-04 10:36:18 ]]> 
  78. </ptime> 
  79. </video> 
  80. </data> 
  81. </xml> 

JSON示例

  1. error: "0", 
  2. data: [ 
  3. images_b: [ 
  4. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_0_b.jpg", 
  5. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1_b.jpg", 
  6. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_2_b.jpg", 
  7. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_3_b.jpg", 
  8. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_4_b.jpg", 
  9. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_5_b.jpg" 
  10. ], 
  11. md5checksum: "44b145c6bea7dd826191990dfb38d1fd", 
  12. tag: "标签", 
  13. mp4: "http://mpv.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.mp4", 
  14. title: "标题", 
  15. df: 2, 
  16. times: "0", 
  17. mp4_1: "http://mpv.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.mp4", 
  18. vid: "36e77ba39c0e5dac84dba418d81a793d_3", 
  19. mp4_2: "http://mpv.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_2.mp4", 
  20. cataid: "1", 
  21. swf_link: "http://player.polyv.net/videos/36e77ba39c0e5dac84dba418d81a793d_3.swf", 
  22. source_filesize: 2295887, 
  23. status: "10", 
  24. seed: 1, 
  25. flv2: "http://plvod01.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_2.flv", 
  26. flv1: "http://plvod01.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.flv", 
  27. sourcefile: "", 
  28. playerwidth: "600", 
  29. hls: [ 
  30. "http://hls.videocc.net/36e77ba39c/3/36e77ba39c0e5dac84dba418d81a793d_1.m3u8", 
  31. "http://hls.videocc.net/36e77ba39c/3/36e77ba39c0e5dac84dba418d81a793d_2.m3u8" 
  32. ], 
  33. default_video: "http://plvod01.videocc.net/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.flv", 
  34. duration: "00:00:33", 
  35. filesize: [ 
  36. 0, 
  37. ], 
  38. first_image: "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_0.jpg", 
  39. original_definition: "672x378", 
  40. context: "描述", 
  41. images: [ 
  42. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_0.jpg", 
  43. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_1.jpg", 
  44. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_2.jpg", 
  45. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_3.jpg", 
  46. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_4.jpg", 
  47. "http://img.videocc.net/uimage/3/36e77ba39c/d/36e77ba39c0e5dac84dba418d81a793d_5.jpg" 
  48. ], 
  49. previewVid: "363c44pl69m0c8klm57kpl715k51l496k_6", 
  50. playerheight: "490", 
  51. ptime: "2017-12-04 11:12:50" 

字段说明

字段 说明
swf_link Flash链接地址
tag 标签
mp4 视频地址
playerwidth 视频宽度
title 视频标题
duration 视频时长
first_image 视频截图
times 点击次数
context 视频描述
images 所有截图
previewVid 预览视频VID
playerheight 视频高度
ptime 上传时间
vid 视频id
cataid 分类id, 如1为根目录
default_video 用户默认播放视频
df 视频码率数
flv1 流畅码率flv格式视频地址
flv2 高清码率flv格式视频地址
flv3 超清码率flv格式视频地址
mp4_1 流畅码率mp4格式视频地址
mp4_2 高清码率mp4格式视频地址
mp4_3 超清码率mp4格式视频地址
hls1 流畅码率hls格式视频地址
hls2 高清码率hls格式视频地址
hls3 超清码率hls格式视频地址
hlsIndex 自适应码率hls播放地址
images_b 视频截图大图地址
seed 加密视频为1,非加密为0
status 视频状态
md5checksum 上传到POLYV云平台的视频源文件的MD5值,可以用来校验是否上传错误或完整
视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
40 视频处理失败
50 等待审核
51 审核不通过
-1 已删除

如果API想调用签名,可参考 http://www.cuplayer.com/cloud/doc/server/11273473.html 按参数签名顺序拼凑字符串为cataid=$(cataid)&JSONRPC=$(JSONRPC)&writetoken=$(writetoken)$(secretkey),并进行sha1计算,得到sign。

 


立即注册使用 快速入门