安卓软件服务器接口文档参考

1、目录用户登录1用户文件列表2用户文件查找5文件下载链接7检查文件名是否存在8准备文件上传8普通上传10断点续传10新建文件夹10删除文件、文件夹11修改文件12修改文件夹12移动文件、文件夹13设置或取消收藏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 为用户密码返回数据成功："state":true,"id":"305806304","token":"7kU3pIQS8MMa0kjfo51BBBbatpI0pP"id:为用户ID， token为登录后产生的值当访问其他接口时需要在请求头中设置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为普通文件，默认为1cid=0为父目录id , 默认为0o=user_ptime 为排序方法 aes=0 0为顺序排列，1为倒序排列offset=0 为从记录的第几条开始limit=28 为每页显示数目type= 为显示类型默认为空显示全部,视频type=4图片type=2文档type=1 音乐type=3star= 是否只显示收藏文件is_share 是否只显示共享nf= 是否不显示文件返回数据"count": 20, /返回数据总数"order": "user_ptime&quo

5、t;, /排序方法"uid": "305806304",/用户id"state": true,/状态是否成功"error": "",/错误信息"errNo": 0,/错误码"time": "0.189",/所用时间"offset": 0,/从第几条记开始"limit": 28, /每页文件数"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,/上传时间或创建时间,"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": /当前路径"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 为每页显示数目value=bbb 为搜索关键字为bbb返回数据"count": 20, /返回数据总数"uid": "305806304",/用户id"state": true,/状态是否成功"error": "",/错误信息"errNo": 0,/错误码"time": "0.189",/所用时间"offset": 0,/从第几条记开始"li

11、mit": 28, /每页文件数"data": "cid": "10071",/文件夹ID"aid": 1,"pid": "0",/父目录"n": "u6211u7684u89c6u9891", /文件夹名"cc": "", /封面"m": "0",/是否为收藏文件 "pc": "fb8885hnf",/pi

12、ck_code唯一码"t": 1382673979,/上传时间或创建时间,"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返回数据"url":":1443 /M00/00/00/wKg4ZVJ56MaAHQluAGN8Gyxg4aA9937687?fn=u6797u5fd7u70ab - u8499u5a1cu4e3du838eu7684u773cu6cea.mp3&k=21f3d92050626fc5a9069bcf06b7c781&t=1386921085","state&quo

15、t;:true,"error":"","errno":""url：为该文件的下载连接地址。url中参数说明fn:为文件名k为防盗值，t为时间。其它说明与默认相同检查文件名是否存在:1443/a1/index?ct=file&ac=checkpost pid=1232&name=aaa.txtpid 为用户所在目录name 为文件名返回结果"state":true,"error":"","errno":"&quo

16、t;,"type":"file"State : True为文件存在， false 为出现错误Error: 当文件不存在时state为false且error值为 FILE_NOT_EXIST, 否则为其他错误原因。Errno: 为错误代码。Type: 当state 为true 时返回type字段，file为文件，dir 为目录准备文件上传Https:/:1443/a1/requestUploadPost sha1=21f3d92050626fc5a9069bcf06b7c781&size=420213&pid=1232&name=a

17、aa.txtsha1 为该文件的sha1值 文件经过sha1加密后的值。size 为文件大小name 文件名pid 为该文件上传目录ID准备上传文件前，请先检查文件名是否存在判断是否存在相同文件名的文件或文件夹，如果存在相同文件名的文件，请用户确认是否覆盖，确实覆盖再进行准备文件上传、普通上传或断点续传，如果存在相同文件名的文件夹，则禁止上传，上传失败。检查文件是否需要上传，以上面url为例，当系统中存在（不一定是该用户）大小为420213且sha1为21f3d92050626fc5a9069bcf06b7c781的文件时，会自动为该用户创建该文件，不需要再重复上传同时返回数据中包含文件信息。

18、data中的us为已经上传的大小，如果us<s 则需要续传剩余部分，如果us=s 则该文件不需要再重新上传，如果data不存在则需要从头上传该文件。返回数据："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",/已经上传文件大小"pc": "11085d03", /只有size=usize时存在"m": "0", /只有size=usize时存在"t": "1382923656"， /文件创建时间

20、只有size=usize时存在"u": "" /文件缩略图 只有size=usize时存在data 为创建好的文件的信息。state errno error等默认普通上传:1443/a1/upload上传文件前先进行准备文件上传操作根据准备文件上传的结果来确定是否进行新文件上传。sha1 为该文件的sha1值，即文件进行sha1加密校验后得到的字符串。size 为文件大小断点续传Https:/:1443/a1/resumeUpload? sha1=21f3d92050626fc5a9069bcf06b7c781&size=420213sha1 为

21、该文件的sha1值，即文件进行sha1加密校验后得到的字符串。size 为文件大小上传文件数据前先进行准备文件上传操作根据准备文件上传的结果来确定是否进行新文件数据上传，及应该从文件的哪部分开始上传。由于是http协议，如果文件过大比如几个M或上G的文件在未全部传到服务器上时续传是没有效果的，所以在启用续传时，需要把文件分割后进行上传，比如每次上传2M或5M，或第一次上传2M，可以根据第一次的上传速度适当调整分割文件大小或分割固定大小，当上传小文件时无需续传等思路。新建文件夹Https:/:1443/a1/index?ct=dir&ac=addpost cname=test&p

22、id=0cname: 为要创建的文件夹名pid 为文件夹所在目录ID返回结果"aid":1,"cid":"10164","cname":"test","pid":"0","state":true,"error":"","errno":""state 返回是否成功。error 失败信息说明errno 失败代码cid 为创建文件夹的IDcname 为创建文件夹名

23、称pid 文件夹所在目录删除文件、文件夹Https:/:1443/a1/index?ct=file&ac=deletePost fid=123,321,3122fid为文件或文件夹ID，以逗号分隔返回数据"state":true,"error":"","errno":""说明默认修改文件Https:/:1443/a1/index?ct=file&ac=editPost fid=1232&file_name=sss&file_desc=jksdfkffid为文件ID

24、.file_name为修改后的文件名，不存在或为空不修改file_desc 为文件备注，不存在或为空不修改返回数据"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为修改后的文件夹名，不存在或为空不修改返回数据"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返回结果"state":true,"error":"","errno":"" 设置或取消收藏Https:/:1443/a1/index?ct=file&ac=starPost fid=1232&is_mark=1fid为文件夹ID.is_mark为是否收藏，为1为收藏

27、，0为不收藏返回数据"state":true,"error":"","errno":""生成文件、文件夹外链:1443/a1/index?ct=link&ac=addPost fid=1232& count=0&time=2014-01-10Fid为文件或文件夹ID count为最大可下载次数，0为不限制time为外链到期时间。当is_link 为0时count ,time 不需要。返回数据"state":true,"error":"","errno":"","link":":1443/link_123213123131.html"取消文件、文件夹外链:1443/a1/index?ct=link&ac=delPost fid=1232323lid为外链ID返回数据"state":true,"error":"","errno":""