安卓軟件服務(wù)器接口文檔參考

1、目錄用戶登錄1用戶文件列表2用戶文件查找5文件下載鏈接7檢查文件名是否存在8準(zhǔn)備文件上傳8普通上傳10斷點續(xù)傳10新建文件夾10刪除文件、文件夾11修改文件12修改文件夾12移動文件、文件夾13設(shè)置或取消收藏13生成文件、文件夾外鏈13取消文件、文件夾外鏈14頭像上傳14頭像下載15用戶信息獲取15密碼找回界面16用戶登錄03:9999/ 03:9999/a1/login?uid=test&passwd=test 03:9999/a1/login?uid=test&

2、passwd=test uid 為用戶名passwd 為用戶密碼返回數(shù)據(jù)成功："state":true,"id":"305806304","token":"7kU3pIQS8MMa0kjfo51BBBbatpI0pP"id:為用戶ID， token為登錄后產(chǎn)生的值當(dāng)訪問其他接口時需要在請求頭中設(shè)置cookiefuid=305806304token=7kU3pIQS8MMa0kjfo51BBBbatpI0pP失敗："state":false,"error":

3、"u672au77e5u9519u8befuff01","errno":900038error:為失敗原因，errno為失敗代碼用戶文件列表03:9999/a1/index?ct=list&aid=1&cid=0&o=user_ptime&asc=0&offset=0&limit=28:1443/a1/index?ct=list&aid=1&cid=0&o=user_ptime&asc=0&offset=0&limit=2

4、8 ssl加密連接ct=list為顯示用戶的文件列表aid=1為普通文件，默認(rèn)為1cid=0為父目錄id , 默認(rèn)為0o=user_ptime 為排序方法 aes=0 0為順序排列，1為倒序排列offset=0 為從記錄的第幾條開始limit=28 為每頁顯示數(shù)目type= 為顯示類型默認(rèn)為空顯示全部,視頻type=4圖片type=2文檔type=1 音樂type=3star= 是否只顯示收藏文件is_share 是否只顯示共享nf= 是否不顯示文件返回數(shù)據(jù)"count": 20, /返回數(shù)據(jù)總數(shù)"order": "user_ptime&quo

5、t;, /排序方法"uid": "305806304",/用戶id"state": true,/狀態(tài)是否成功"error": "",/錯誤信息"errNo": 0,/錯誤碼"time": "0.189",/所用時間"offset": 0,/從第幾條記開始"limit": 28, /每頁文件數(shù)"aid": 1,/普通文件"cid": 0,/顯示哪個目錄ID下的

6、文件及文件夾"is_asc": 0,/是否順序排序"star": 0,/是否只顯示收藏"is_share": 0，/是否只顯示共享"type": 0,/顯示類型"data": "cid": "10071",/文件夾ID"aid": 1,"pid": "0",/父目錄"n": "u6211u7684u89c6u9891", /文件夾名"cc"

7、;: "", /封面"m": "0",/是否為收藏文件 "pc": "fb8885hnf",/pick_code唯一碼"t": 1382673979,/上傳時間或創(chuàng)建時間,"fid": 10095,/文件ID"aid": 1,"pid": 0,/所在文件夾ID"n": "crashreporter.exe","s": "116632",/

8、文件大小"pc": "11085d03","m": "0","t": "1382923656"，"u": "35/thumb/4d/fb/4dfb7f9a94f339b4382ac93b28c7557a9b147b31_100_100?_t=1382933175", /文件縮略圖"sha1": "4dfb7f9a94f339b4382ac93b28c7557a9b147b3

9、1"/文件sha1碼,"path": /當(dāng)前路徑"name": "u7f51u76d8u6587u4ef6","aid": 1,"cid": 0,"pid": 0用戶文件查找:1080/a1/index?ct=file&ac=search:1443/a1/index?ct=file&ac=search ssl加密連接Post offset=0&limit=28&value=bbbct=file&ac=search固定offse

10、t=0 為從記錄的第幾條開始limit=28 為每頁顯示數(shù)目value=bbb 為搜索關(guān)鍵字為bbb返回數(shù)據(jù)"count": 20, /返回數(shù)據(jù)總數(shù)"uid": "305806304",/用戶id"state": true,/狀態(tài)是否成功"error": "",/錯誤信息"errNo": 0,/錯誤碼"time": "0.189",/所用時間"offset": 0,/從第幾條記開始"li

11、mit": 28, /每頁文件數(shù)"data": "cid": "10071",/文件夾ID"aid": 1,"pid": "0",/父目錄"n": "u6211u7684u89c6u9891", /文件夾名"cc": "", /封面"m": "0",/是否為收藏文件 "pc": "fb8885hnf",/pi

12、ck_code唯一碼"t": 1382673979,/上傳時間或創(chuàng)建時間,"fid": 10095,/文件ID"aid": 1,"pid": 0,/所在文件夾ID"n": "crashreporter.exe","s": "116632",/文件大小"pc": "11085d03","m": "0","t": "13829236

13、56"，"u": "35/thumb/4d/fb/4dfb7f9a94f339b4382ac93b28c7557a9b147b31_100_100?_t=1382933175", /文件縮略圖"sha1": "4dfb7f9a94f339b4382ac93b28c7557a9b147b31"/文件sha1碼文件下載鏈接Https:/:1443/a1/index?ct=file&ac=url 03:9999/a1/index?c

14、t=file&ac=url每次下載文件時請重新通過上面鏈接申請下載地址，該鏈接會過期，過期時間最大不超過一天最小1小時。Post fid=123fid為文件ID返回數(shù)據(jù)"url":":1443 /M00/00/00/wKg4ZVJ56MaAHQluAGN8Gyxg4aA9937687?fn=u6797u5fd7u70ab - u8499u5a1cu4e3du838eu7684u773cu6cea.mp3&k=21f3d92050626fc5a9069bcf06b7c781&t=1386921085","state&quo

15、t;:true,"error":"","errno":""url：為該文件的下載連接地址。url中參數(shù)說明fn:為文件名k為防盜值，t為時間。其它說明與默認(rèn)相同檢查文件名是否存在:1443/a1/index?ct=file&ac=checkpost pid=1232&name=aaa.txtpid 為用戶所在目錄name 為文件名返回結(jié)果"state":true,"error":"","errno":"&quo

16、t;,"type":"file"State : True為文件存在， false 為出現(xiàn)錯誤Error: 當(dāng)文件不存在時state為false且error值為 FILE_NOT_EXIST, 否則為其他錯誤原因。Errno: 為錯誤代碼。Type: 當(dāng)state 為true 時返回type字段，file為文件，dir 為目錄準(zhǔn)備文件上傳Https:/:1443/a1/requestUploadPost sha1=21f3d92050626fc5a9069bcf06b7c781&size=420213&pid=1232&name=a

17、aa.txtsha1 為該文件的sha1值 文件經(jīng)過sha1加密后的值。size 為文件大小name 文件名pid 為該文件上傳目錄ID準(zhǔn)備上傳文件前，請先檢查文件名是否存在判斷是否存在相同文件名的文件或文件夾，如果存在相同文件名的文件，請用戶確認(rèn)是否覆蓋，確實覆蓋再進(jìn)行準(zhǔn)備文件上傳、普通上傳或斷點續(xù)傳，如果存在相同文件名的文件夾，則禁止上傳，上傳失敗。檢查文件是否需要上傳，以上面url為例，當(dāng)系統(tǒng)中存在（不一定是該用戶）大小為420213且sha1為21f3d92050626fc5a9069bcf06b7c781的文件時，會自動為該用戶創(chuàng)建該文件，不需要再重復(fù)上傳同時返回數(shù)據(jù)中包含文件信息。

18、data中的us為已經(jīng)上傳的大小，如果us<s 則需要續(xù)傳剩余部分，如果us=s 則該文件不需要再重新上傳，如果data不存在則需要從頭上傳該文件。返回數(shù)據(jù)："state":true,"error":"","errno":"","data":"fid": 10095,/文件ID只有size=usize時存在"aid": 1,/只有size=usize時存在"pid": 0,/所在文件夾ID 只有size=usi

19、ze時存在"n": "crashreporter.exe", /文件名 只有size=usize時存在"s": "420213",/文件大小"us": "420213",/已經(jīng)上傳文件大小"pc": "11085d03", /只有size=usize時存在"m": "0", /只有size=usize時存在"t": "1382923656"， /文件創(chuàng)建時間

20、只有size=usize時存在"u": "" /文件縮略圖 只有size=usize時存在data 為創(chuàng)建好的文件的信息。state errno error等默認(rèn)普通上傳:1443/a1/upload上傳文件前先進(jìn)行準(zhǔn)備文件上傳操作根據(jù)準(zhǔn)備文件上傳的結(jié)果來確定是否進(jìn)行新文件上傳。sha1 為該文件的sha1值，即文件進(jìn)行sha1加密校驗后得到的字符串。size 為文件大小斷點續(xù)傳Https:/:1443/a1/resumeUpload? sha1=21f3d92050626fc5a9069bcf06b7c781&size=420213sha1 為

21、該文件的sha1值，即文件進(jìn)行sha1加密校驗后得到的字符串。size 為文件大小上傳文件數(shù)據(jù)前先進(jìn)行準(zhǔn)備文件上傳操作根據(jù)準(zhǔn)備文件上傳的結(jié)果來確定是否進(jìn)行新文件數(shù)據(jù)上傳，及應(yīng)該從文件的哪部分開始上傳。由于是http協(xié)議，如果文件過大比如幾個M或上G的文件在未全部傳到服務(wù)器上時續(xù)傳是沒有效果的，所以在啟用續(xù)傳時，需要把文件分割后進(jìn)行上傳，比如每次上傳2M或5M，或第一次上傳2M，可以根據(jù)第一次的上傳速度適當(dāng)調(diào)整分割文件大小或分割固定大小，當(dāng)上傳小文件時無需續(xù)傳等思路。新建文件夾Https:/:1443/a1/index?ct=dir&ac=addpost cname=test&p

22、id=0cname: 為要創(chuàng)建的文件夾名pid 為文件夾所在目錄ID返回結(jié)果"aid":1,"cid":"10164","cname":"test","pid":"0","state":true,"error":"","errno":""state 返回是否成功。error 失敗信息說明errno 失敗代碼cid 為創(chuàng)建文件夾的IDcname 為創(chuàng)建文件夾名

23、稱pid 文件夾所在目錄刪除文件、文件夾Https:/:1443/a1/index?ct=file&ac=deletePost fid=123,321,3122fid為文件或文件夾ID，以逗號分隔返回數(shù)據(jù)"state":true,"error":"","errno":""說明默認(rèn)修改文件Https:/:1443/a1/index?ct=file&ac=editPost fid=1232&file_name=sss&file_desc=jksdfkffid為文件ID

24、.file_name為修改后的文件名，不存在或為空不修改file_desc 為文件備注，不存在或為空不修改返回數(shù)據(jù)"state":true,"error":"","errno":"",file_name: "sss",file_desc: "jksdfkf"file_name為修改成功后的文件名file_desc為備注修改文件夾Https:/:1443/a1/index?ct=dir&ac=editPost fid=1232&file_na

25、me=sss&file_desc=jksdfkffid為文件夾ID.file_name為修改后的文件夾名，不存在或為空不修改返回數(shù)據(jù)"state":true,"error":"","errno":"",file_name: "sss"file_name為修改成功后的文件名移動文件、文件夾Https:/:1443/a1/index?ct=dir&ac=movePost fid=1232&pid=123211移動文件，或文件夾前，請先檢查文件名是否存在,如

26、果移動的為文件，且存在相同的文件請用戶選擇是否覆蓋，如果存在相同名稱的文件夾，則禁止移動。如果移動的為文件夾，且存在相同名稱的文件夾或文件，則移動失敗。fid 為需要移動的文件或文件夾IDpid 為移動到的文件夾ID返回結(jié)果"state":true,"error":"","errno":"" 設(shè)置或取消收藏Https:/:1443/a1/index?ct=file&ac=starPost fid=1232&is_mark=1fid為文件夾ID.is_mark為是否收藏，為1為收藏

27、，0為不收藏返回數(shù)據(jù)"state":true,"error":"","errno":""生成文件、文件夾外鏈:1443/a1/index?ct=link&ac=addPost fid=1232& count=0&time=2014-01-10Fid為文件或文件夾ID count為最大可下載次數(shù)，0為不限制time為外鏈到期時間。當(dāng)is_link 為0時count ,time 不需要。返回數(shù)據(jù)"state":true,"error":"","errno":"","link":":1443/link_123213123131.html"取消文件、文件夾外鏈:1443/a1/index?ct=link&ac=delPost fid=1232323lid為外鏈ID返回數(shù)據(jù)"state":true,"error":"","errno":""