cute http file server API 教程与用户指南

"cute http file server 是一个支持图形界面的轻量级HTTP文件服务器，其开发API主要包括用户认证和文件操作两大模块。该服务器的开发文档可在GitHub的docblue/chfsgui项目中找到。" 在cute http file server的API中，用户认证和文件操作是两个关键功能： ### 用户认证 #### 1.1. 用户登录 用户登录是通过POST请求到/session接口完成的。请求中需要包含两个 formData 参数： - `pwd`：用户的密码，必填。 - `user`：用户名，必填。 当登录成功时，服务器返回201状态码，数据包含一个`token`，这个`token`会被设置为Cookie的`JWT`值。如果账号或密码错误，将返回404状态码，表示错误信息。如果参数错误，会返回400状态码，服务器内部错误则返回500状态码。 #### 1.2. 用户登出 用户登出是通过DELETE请求到/session接口实现的。请求头需包含已登录获取的`JWT` Token。成功登出后，服务器返回204状态码，清除Cookie中的`JWT`。如果Token无效，将返回401状态码，表示错误信息。 ### 文件操作 #### 2.1. 获取文件列表 获取文件列表是通过GET请求到/files接口。请求参数包括： - `filepath`：查询的目录路径，作为querystring参数，必填。 请求头需要包含登录后的`JWT` Token。成功返回文件列表，服务器内部错误则返回500状态码。 #### 2.2. 删除文件或目录 文件或目录的删除操作未在提供的信息中详细说明，但通常这类操作会有类似的接口，如DELETE请求，并需要提供文件或目录的路径。 #### 2.3. 新建目录 新建目录的API通常会有一个POST请求接口，需要指定新目录的名称和位置。 #### 2.4. 新建文本 创建新文本文件可能涉及POST请求，包含文件名和内容。 #### 2.5. 下载文件 下载文件通常通过GET请求实现，提供文件路径，返回文件内容。 #### 2.6. 下载目录 下载整个目录可能涉及压缩文件并提供下载链接。 #### 2.7. 判断文件是否存在 检查文件是否存在可能通过GET请求接口，返回布尔值表示文件是否存在。 #### 2.8. 上传文件 文件上传通常使用POST请求，包含文件内容和目标存储路径。 #### 2.9. 重命名 重命名文件或目录可能涉及PUT请求，提供新的文件或目录名。 这些API提供了对文件服务器的基本操作，涵盖了用户认证和文件管理的核心功能。开发者可以根据这些接口实现与cute http file server的交互，如构建客户端应用程序，实现文件的上传、下载、管理等功能。