本文档由小幺鸡编辑

童话森林系统开发说明:

1.api请求都是返回json,部分是获取cookie、部分是直接下载(content-type:)

2.每一个接口都需要cookie,所以客户端登录之后要保存好cookie里面的数据,网络请求的headers所有内容:

GET http://magic.scclbl.com/index.php?explorer/fileDownload&path=D%253A%252FphpStudy%252FWWW%252Fkodexplorer-old%252Fdata%252Fpublic%252F%25E5%25BE%25AE%25E4%25BF%25A1%25E5%259B%25BE%25E7%2589%2587_20170803102309.jpg HTTP/1.1
Host: localhost
Connection: keep-alive
Pragma: no-cache
Cache-Control: no-cache
Upgrade-Insecure-Requests: 1
User-Agent: Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.94 Safari/537.36
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
Referer: http://localhost/
Accept-Encoding: gzip, deflate, br
Accept-Language: zh-CN,zh;q=0.9,zh-TW;q=0.8,ja;q=0.7
Cookie: optimizelyEndUserId=oeu1512026333636r0.24201613632989583; Phpstorm-87285b69=5df1dcad-51bf-4703-bd35-f7935fe38958; _ga=GA1.1.696667543.1512026335; kod_user_language=zh_CN; XSRF-TOKEN=eyJpdiI6IktaXC93dzRGY2laR3pGbGVCM2NUbWJ3PT0iLCJ2YWx1ZSI6ImRibFlYUXlpV0F6YVoxVkhOQTVXaExmUWQyWTNmXC9lc0VpS1I3UzY0SGExQ1E3TG8xNnd1bDhYV3FaZXdzZEFJYk9YbTJjblhcL1ZSVWhaM2pvcFltWEE9PSIsIm1hYyI6ImRlYzQ3MDQ0Yjk5MTBmZjcxM2QwNzc4YTE5MGRmZWRmODkyMDgxYmIxMWVlNmMyZGE0MDdiNTJjNDRlNGNiMjYifQ%3D%3D; laravel_session=eyJpdiI6IitEMmJnTXkwTHZlQlwvd0tSSEJYOGtnPT0iLCJ2YWx1ZSI6ImtzQmlEQ01MUkdNdkJVM0xDKzdNVFZqVEJmSURHZGFRanNERTZ3cjViOEh1U1dBaFN6cGkxRU04QWJIOHVabGFHdmRxM0VGMFp1ZFBtMThLblhPTk93PT0iLCJtYWMiOiI1NDIxNDc1YjY0ZmNhNmU3ZWY3MjNjYTk3NzJlOTFlYzFjMTFmZTc0YWRhMmUxNGVkNDhjNjYzNTQ4NTNjYWQ0In0%3D; kod_name=demo; kod_token=8bed97cd9cf76eeed53d24724f86c7a6; PHPSESSID=boakcom0uk9v6tp8h8e4pf0md3; kod_user_online_version=check-at-1514535247 

其中Cookie就是上面的数据。


3.系统api主要使用此文件夹【童话森林】、上面的可道和够快只是我的参考的草稿api,这儿的api我会补充好中文说明,以及参数不同类型代表什么意思,可能部分类型会不全面,前端代码注意为此类问题预留。

4.其他新增说明会列到下面…………


20171230_add_comment

排列方式和查看方式的排列是在客户端处理的,同时请求接口

左边菜单栏的 我的收藏夹 权限文档  公共目录  回收站 当前先写死,请求时对应的path值来自 explorer/treeList 里面的  this_path字段值

收藏夹 

权限文档 

公共目录 D:/phpStudy/WWW/magicforest_service/data/public/ 

回收站 

关于当前路径的处理:

a)点击左边目录  已有路径值

b)点击文件夹   已有路径值

c)前进、后腿   已有路径值

d)点击顶栏的层级    通过拼接 【D:/phpStudy/WWW/magicforest_service/data/】【public/】【my_folder】 这三部分


5.关于多选的问题

a)复制可以多选

b)收藏不可以多选

c)上传和下载可以多选,上传多选是多个请求,下载多个文件是下载压缩包

d)


6.原始接口的文字提示和返回数组使用的字段问题,其中部分接口如下

a)

{
    "code": true,
    "use_time": 0.0055010318756104,
    "data": "【复制】—— 覆盖剪贴板成功!"
}

b)

{
    "code": true,
    "use_time": 0.0075008869171143,
    "data": [
        "1.txt"
    ],
    "info": "粘贴操作完成"
}

前端代码使用这样的逻辑来写

A)业务只需要文字时,提示的文字先找info字段,如果有info则显示info,如果没有info则使用data字段。

B)业务需要只有返回数组时,数据永远都是用data

C)既有文字又有数组时,文字找info,数组找data。