Path: API › 文件管理 `POST /files` 读取或保存文件内容，用于面板在线编辑器。 ## Request body _Required._ - `action126.request_time` (string, required) — Unix 时间戳。 - `action126.request_token` (string, required) — 按 API 概览生成的签名。 ## Example request ```text { "request_time": "string", "request_token": "string" } ``` ## Code samples ### cURL（填写面板地址与签名） ```curl curl --request POST \ --url "https://your-panel.example.com:8888/files" \ --header "Content-Type: application/x-www-form-urlencoded" \ --data-urlencode "request_time=" \ --data-urlencode "request_token=<按 API 概览生成的签名>" ``` ## Responses ### default 接口响应，业务状态见下方详细说明。 #### Example ```json { "status": true, "only_read": false, "size": 917, "encoding": "utf-8", "data": "..." } ``` - `action126.response.default.status` (boolean, optional) — `true` - `action126.response.default.data` (string, optional) — 文件内容 - `action126.response.default.encoding` (string, optional) — 检测到的编码（如 `utf-8`） - `action126.response.default.size` (integer, optional) — 文件大小（字节） - `action126.response.default.only_read` (boolean, optional) — 是否只读 ## GetFileBody ## GetFileBody / SaveFileBody 读取或保存文件内容，用于面板在线编辑器。 - **路由**：`POST /files` ## GetFileBody 读取文件内容，自动检测编码。 | 参数名称 | 必选 | 类型 | 描述 | |----------|------|------|------| | action | 是 | String | `GetFileBody` | | path | 是 | String | 文件路径 | ### 输出参数 | 参数名称 | 类型 | 描述 | |----------|------|------| | status | Boolean | `true` | | data | String | 文件内容 | | encoding | String | 检测到的编码（如 `utf-8`） | | size | Integer | 文件大小（字节） | | only_read | Boolean | 是否只读 | ### 示例 ```json {"status": true, "only_read": false, "size": 917, "encoding": "utf-8", "data": "..."} ``` ## SaveFileBody 保存编辑后的内容到文件。 | 参数名称 | 必选 | 类型 | 描述 | |----------|------|------|------| | action | 是 | String | `SaveFileBody` | | path | 是 | String | 文件路径（必须已存在） | | data | 是 | String | 新内容 | | encoding | 是 | String | 编码，如 `utf-8` | > 文件必须已存在且面板有写入权限。