# 文件管理后台

基于Filesite对用户上传的内容进行管理，包括以下功能。

## 登陆

不提供注册功能，后台管理账号及密码需在配置文件里设置。


## 目录/文件管理

免费功能：
* 上传
* 下载
* 重命名
* 删除
* 移动
* 创建目录


付费功能：
* zip包解压缩
* 打包目录/文件下载
* 获取目录/文件分享链接


## 系统

* 配置

1. 是否需要用户登陆才能访问
2. 授权登陆密码设置
3. 最大可上传文件大小


----

以下其它业务相关功能为收费版才有的。

## tag标签管理

* 添加
* 修改
* 重命名
* 删除
* 获取分享链接


## 收款设置

支持微信、支付宝二维码收款，
需特别申请、无需对接公众号，有收款码就能用。

备注：用户下单必须填写昵称，方便后台查找订单


## 目录/文件/tag标签付费设置

付费浏览模式支持：
* 当前链接内容前几个免费，其它的需要付费浏览
* 全站（可每天）免费试看几个，其它的需要付费浏览
* 当前链接需要付费浏览
* 浏览免费，下载需要付费
* 视频可以设置观看一定时间后收费才能继续观看


## 订单管理

* 每日、每月收入汇总
* 订单浏览，可按日期、时间筛选
* 订单状态修改（待付款、已付款、已退款）


----

## 后台所需的PHP扩展

* gd
* mbstring


## API请求方法和传参方式

除了无参数或允许无参数之外的API都只支持POST方式传参数，
数据格式支持两种：
* form data
* json body


## API及其返回数据格式

后台所用的接口统一在/api/下，其中返回数据格式为：
```
{
    code: 0,        //0或1，0 表示失败，1 表示成功
    msg: "",        //处理完成的提示信息
    err: "",        //处理出错的提示信息
    data: []        //返回数据
}

```


接口返回的HTTP状态码对照：
| 状态码 | 意义 |
| ---- | ---- |
| 200 | 成功 |
| 401 | 未授权 |
| 402 | 未购买 |
| 403 | 禁用 |
| 404 | 不存在 |
| 500 | 系统错误 |
| 302 | 重定向 |


基础功能接口：

下面用中括号包起来的参数为可选参数。

| 地址 | 说明 | 状态 | 参数 |
| ---- | ---- | ---- | ---- |
| /api/captcha/ | 验证码图片 | ✓ | [refresh] |
| /api/login/ | 登陆 | ✓ | username, password, [captcha] |
| /api/ls/ | 目录/文件列表 | ✓ | [id：目录id，可选] |
| /api/mkdir/ | 创建目录 | ✓ | dir, [parent] |
| /api/delete/ | 删除文件 | ✓ | file, [parent] |
| /api/rmdir/ | 删除目录 | ✓ | dir, [parent] |
| /api/move/ | 移动目录/文件 | ✓ | from, to |
| /api/rename/ | 重命名目录/文件 | ✓ | from, to, [parent] |
| /api/uploadbase64/ | 上传base64格式文件 | ✓ | file, name, [parent] |
| /api/switchtheme/ | 更换皮肤 | ✓ | theme, [contentdir] |


参数说明：
* 更换皮肤接口参数theme，可选值：```['manual', 'webdirectory', 'googleimage', 'videoblog']```
* 更换皮肤接口参数contentdir为可选，是一个目录名，不能包含斜杠**/**字符


付费功能接口：

| 地址 | 说明 | 状态 | 参数 |
| ---- | ---- | ---- | ---- |
| /api/download/ | 下载文件 | - | - |
| /api/config/ | 系统配置 | - | - |
| /api/changepwd/ | 修改密码 | - | - |
| /api/zip/ | zip打包目录 | - | - |
| /api/unzip/ | zip包解压缩 | - | - |
| /api/share/ | 获取分享链接 | - | - |
| /api/paymentconfig/ | 收款码配置 | - | - |
| /api/orderlist/ | 订单列表 | - | - |
| /api/orderstatusswitch/ | 订单状态切换 | - | - |
| /api/taglist/ | 标签列表 | - | - |
| /api/tagadd/ | 添加标签 | - | - |
| /api/tagrename/ | 重命名标签 | - | - |
| /api/tagset/ | 标签内容设置 | - | - |
| /api/tagdelete/ | 删除标签 | - | - |
| /api/tagshare/ | 标签分享链接获取 | - | - |