lipengjava

upload media

  1 +/**
  2 + * @api {post} /DocSharing/mediaUploadForeign 26.上传伴音文件
  3 + * @apiName mediaUploadForeign
  4 + * @apiGroup doc
  5 + * @apiVersion 1.6.0
  6 + * @apiDescription 上传伴音文件。<br/>
  7 + * 只允许 mp3 文件
  8 + * 需要用到22接口中得到的文档服务器地址。
  9 + *
  10 + * @apiParam {String} siteId 站点标识
  11 + * @apiParam {Long} timestamp 时间戳
  12 + * @apiParam {String} authId MD5(key+siteId+timestamp), 其中 key 为与系统约定的加密 key
  13 + * @apiParam {String} createUserName 上传者名字
  14 + * @apiParam {String} createUserID 上传者 id
  15 + *
  16 + * @apiParamExample {form-data} 请求示例
  17 + &lt;html&gt;
  18 + &lt;body&gt;
  19 + 上传文件程序应用示例
  20 + &lt;form action="mediaUploadForeign" method="post" enctype="multipart/form-data"&gt;
  21 + 请选择要上传的文件&lt;input type="file" name="upfile" size="50"&gt;
  22 + siteID:&lt;input type="text" name="siteID" size="50" value="admin"&gt;
  23 + timestamp:&lt;input type="text" name="timestamp" size="50" value="1442286924284"&gt;
  24 + authId:&lt;input type="text" name="authId" size="50" value="68e150f469667a9972b7f82bc6ec0877"&gt;
  25 + createUserName:&lt;input type="text" name="createUserName" size="50" value="admin"&gt;
  26 + createUserID:&lt;input type="text" name="createUserID" size="50" value="402880f44fa5bcac014fa5dff5330001"&gt;
  27 + &lt;input type="submit" value="提交"&gt;
  28 + &lt;/form&gt;
  29 + &lt;/body&gt;
  30 + &lt;/html&gt;
  31 + *
  32 + * @apiSuccess {Array} docList
  33 + * @apiSuccess {Object} docList.doc
  34 + * @apiSuccess {int} errorCode
  35 + * 0:成功 <br/>
  36 + * 1:siteId 错误 <br/>
  37 + * 2:站点未到生效日期 <br/>
  38 + * 3:站点过期 <br/>
  39 + * 4:authId 错误 <br/>
  40 + * 5:authId 不能重复使用 <br/>
  41 + * 6:timestamp 超时 <br/>
  42 + * 7:上传格式不正确 <br/>
  43 + * @apiSuccess {String} mediaId id
  44 + * @apiSuccess {String} filepath 绝对路径
  45 + * @apiSuccess {String} relativeLocation 相对路径
  46 + * @apiSuccess {String} filetype 文件类型
  47 + * @apiSuccess {String} fileName 文件名称
  48 + *
  49 + * @apiSuccessExample {xml} 返回示例
  50 + &lt;?xml version=“1.0” encoding="UTF-8"?&gt;
  51 + &lt;result&gt;
  52 + &lt;errorCode&gt;0&lt;/errorCode&gt;
  53 + &lt;mediaId&gt;402880f84ff3bf77014ff3c0bcdb0002&lt;/mediaId&gt;
  54 + &lt;filepath&gt;http://127.0.0.1:8080/DocSharing/data/0/20151009-104200/0eb9a0c3781f5017c866127067a7e968.mp3&lt/filepath&gt;
  55 + &lt;relativeLocation&gt;/DocSharing/data/0/20151009-104200/0eb9a0c3781f5017c866127067a7e968.mp3&lt;/relativeLocation&gt;
  56 + &lt;filetype&gt;mp3&lt;/filetype&gt;
  57 + &lt;fileName&gt;凤凰传奇 - 我和草原有个约定.mp3&lt;/fileName&gt;
  58 + &lt;/result&gt;
  59 + *
  60 + */