上传api接口说明

上传接口说明

参数说明

uploaddkey:后台系统设置-上传设置-上传密钥

md5值是取文件前10M作为文件md5值

可以参考文件/work/public/upload/js/upload.js

 

上传接口说明

视频的上传是基于标准 web页面上传,是分片式的上传,以保证最大化的传输效率及断点续传,用户需要对上传的文件进行固定尺寸的分片,每次上传一个分片,当所有分片上传完成后,向服务器发送合并分片的请求,完成文件的整体上传。基本流程如下:

ReferenceError: Diagram is not defined
  • 检测分片是否存在(chunkCheck)时 ,如果分片已经存在可以直接跳过,传输下一个分片,依次类推

  • 文件分片不宜过小,建议按照 10 * 1024 * 1024 进行分片

  • 下面的接口说明以javascript举例,重点关注 URL的传参及服务器的数据回应即可。

文件是否存在检测

通过MD5检测上传的文件是否已经存在,如果存在,返回文件信息,URL请求参数说明:

  • status 固定值 md5Check

  • md5 md5值

  • uploadkey 上传秘钥

//请求URLconst url = 'http://播放域名/uploads?status=md5Check&uploadkey=uploaddkey&md5=文件md5值'//文件存在的响应:$.post(url, function(data) {
   //文件存在响应格式
   data = {
      ifExist: 1,
      duration: 30, //影片时长
      title: "",//标题
      path: "", //路径
      pic: "", //图片路径
      pics: "",
      gif: "", //动态图片路径
      qr: "", //二维码路径
      orgfile: "", //原始文件
      url: "", //m3u8的url
      mp4: "", // mp4 文件路径
      share: "" //分享地址路径
   }

   //文件不存在响应格式
   data = {
      ifExist: 0
    
   }});

分片检测

检测指定的文件分片是否存在,URL请求参数说明:

  • chunkIndex 表示分片索引,从0开始计数。

  • name md5值

  • size 当前分片长度

//请求URLconst url = 'http://播放域名/uploads?status=chunkCheck&name=md5&size=1024000&chunkIndex=3'
//文件存在的响应:$.post(url, function(data) {
   //文件存在响应格式
   data = {
      ifExist: 1,
   }

   //文件不存在响应格式
   data = {
      ifExist: 0
   }});

分片上传

通过标准的form表单方式上传文件分片,注意form 表单的编码类型应该为 multipart/form-data.
form表单字段说明:

  • userId 上传秘钥

  • uniqueFileName md5值

  • chunk 3 当前上传的分片索引

//请求URLconst url = 'http://播放域名/uploads'
//响应200表示成功,其他失败

注意在上传时,请保证userId 是表单中的第一个字段,如果编程实现,构造formdata 时候,也务必保证将userId 字段放在分片内容之前,否则会出现校验失败

分片合并

所有分片传输完成后,执行此操作,服务器将对之前上传的所有分片进行校验并合并,URL请求字段说明:

  • status 固定值chunksMerge

  • md5 md5值

  • chunks 分片总数

  • name md5值

  • fileoldname 原始文件名(不带扩展名)

  • ext 原始文件扩展名(不带.) 比如 mp4

 url  $url  
   
   data  
    duration  
    title 
    path  
    pic  
    pics 
    gif  
    qr  
    orgfile  
    url  
    mp4  
    share  

   
   data   error

 

以下是java环境的上传代码:

sdk下载https://github.com/ppvod/upload-sdk


免责声明:
1;所有标注为智造资料网zl.fbzzw.cn的内容均为本站所有,版权均属本站所有,若您需要引用、转载,必须注明来源及原文链接即可,如涉及大面积转载,请来信告知,获取《授权协议》。
2;本网站图片,文字之类版权申明,因为网站可以由注册用户自行上传图片或文字,本网站无法鉴别所上传图片或文字的知识版权,如果侵犯,请及时通知我们,本网站将在第一时间及时删除,相关侵权责任均由相应上传用户自行承担。
内容投诉
智造资料网打造智能制造3D图纸下载,在线视频,软件下载,在线问答综合平台 » 上传api接口说明