文件上傳下載說明文檔v1.0

1、文件服務器說明編制人員：編制部門：新興業(yè)務與技術部模版文件版本：V1.0.0適用項目范圍：平臺2.671 概述2 文件上傳鏈接2.1 通用上傳鏈接設計說明此鏈接用于普通文件、圖片、音頻和視頻上傳（視頻上傳暫無使用場景）版本說明請求鏈接/file/sid/sid/flagTemp/flagTemp/提交數(shù)據(jù)參數(shù)中文含義必填備注sidService的名稱是當前使用的service的名稱flagTemp是否為臨時文件是1-臨時文件,0-永久文件input=file上傳的文件 是Form表單類型需為multipart/form-data，需要用post提交返回數(shù)據(jù)參數(shù)說明參數(shù)中文含義類型備注公共節(jié)點參

2、數(shù)說明state狀態(tài)代碼String0-失敗,1-成功status登錄狀態(tài)int0-游客,1-登錄用戶msg狀態(tài)信息String相關提示信息data節(jié)點參數(shù)說明state是否上傳成功String0-不成功1-成功msg提示信息String上傳成功/上傳失敗fileId文件id String上傳失敗時返回空字符串filePath文件路徑 String上傳失敗時返回空字符串返回數(shù)據(jù)數(shù)據(jù)結構例：頭像上傳- /file/sid/userCenterService/flagTemp/1/json:state:1,data:state:,msg:,fileId:, filePath:,msg:,statu

3、s:12.2 帶有寬高比例參數(shù)的圖片上傳鏈接設計說明此鏈接僅用于圖片上傳版本說明請求鏈接/file/sid/sid/flagTemp/flagTemp/w/w/h/h/r/r/提交數(shù)據(jù)參數(shù)中文含義必填備注sidService的名稱是當前使用的service的名稱flagTemp是否為臨時文件是1-臨時文件,0-永久文件w期望圖片寬度否不設定寬度則為nullh期望圖片高度否不設定高度則為nullr期望圖片比例否不設定比例則為nullinput=file上傳的文件 是Form表單類型需為multipart/form-data，需要用post提交返回數(shù)據(jù)參數(shù)說明參數(shù)中文含義類型備注公共節(jié)點參數(shù)說明s

4、tate狀態(tài)代碼String0-失敗,1-成功status登錄狀態(tài)int0-游客,1-登錄用戶msg狀態(tài)信息String相關提示信息data節(jié)點參數(shù)說明state是否上傳成功String0-不成功1-成功msg提示信息String上傳成功/上傳失敗fileId文件id String上傳失敗時返回空字符串filePath文件路徑 String根據(jù)w,h,r生成壓縮后的圖片鏈接，傳失敗時返回空字符串返回數(shù)據(jù)數(shù)據(jù)結構例：頭像上傳- /file/sid/userCenterService/flagTemp/1/w/320/h/320/r/null/json:state:1,data:state:,ms

5、g:,fileId:, filePath:,msg:,status:13 文件下載鏈接3.1 圖片和普通文件下載鏈接設計說明此鏈接用于普通文件、圖片下載和斷點續(xù)傳版本說明請求鏈接/file/displayName/提交數(shù)據(jù)參數(shù)中文含義必填備注displayName下載文件的名稱是對應T_MCP_FILE中的NAME_DISP字段filePath文件保存相對路徑是對應T_MCP_FILE中的PATH_FILE字段w期望圖片高度否僅用于圖片下載h期望圖片高度否僅用于圖片下載r期望圖片高度否僅用于圖片下載compress期望圖片處理方式否僅用于圖片下載sall按照最小邊壓縮slide-根據(jù)目標比例和

6、原圖比例，壓縮并拉伸ratio-根據(jù)目標比例和原圖比例，壓縮但不拉伸cut-圖寬高比例和目標寬高比例比較進行壓縮,壓縮后圖片超過目標尺寸的部分被截取press添加水印否僅用于圖片下載，默認添加水印0不添加水印返回數(shù)據(jù)參數(shù)說明參數(shù)中文含義類型備注輸出文件流返回數(shù)據(jù)數(shù)據(jù)結構例：/file/img_0.jpg/?filePath=/picture/2012/12/08/post/ff80808139cf33440139d435edd008a3/ecfd5016-3c0f-4027-b0e1-da37bff96d28.jpg&w=140&h=105&press=0&compress=cut3.2 音頻下載鏈接設計說明此鏈接用于音頻下載版本說明請求鏈接/audioFile/displayName/提交數(shù)據(jù)參數(shù)中文含義必填備注displayName下載文件的名稱是對應T_MCP_FILE中的NAME_DISP字段client下載文件的終端是android安卓系統(tǒng)ios蘋果系統(tǒng)browser瀏覽器（用于避免緩存）downloadType下載方式否目前僅用于斷點續(xù)傳，傳入固定值：resume返回數(shù)據(jù)參數(shù)說明參數(shù)中文含義類型備注輸出文件流返回數(shù)據(jù)數(shù)據(jù)結構例：/audioFile/recorder.caf