LICENSE

all content, endpoints, and code provided by this API are licensed under the GNU Affero General Public License v3 (AGPL-3.0).

By accessing or using this API, you agree to comply with the terms of the AGPLv3.

For more details, please read the full license at GNU AGPLv3.

文件操作接口

Developing

GET

/@file/{action}/{method}/{source}

接口用途

负责和后端文件系统对接

接口示例

列出目录

示例操作	含义
`/@file/list/uuid/123456?driver=0`	以`UUID`方式列出`UUID`为`12345`的目录下的文件
`/@file/list/path/path1/sub_path/`	列出`/path1/sub_path/`路径的目录下的文件

获取链接

示例操作	含义
`/@file/link/uuid/123456?driver=0`	以`UUID`方式获取`UUID`为`12345`的文件地址
`/@file/link/path/path1/file1.mp4`	获取`/path1/file1.mp4`路径的文件下载URL

复制文件(夹)

示例操作	含义
`/@file/copy/uuid/123456?driver=0&target=/path/path2/`	以`UUID`方式复制`UUID`为`12345`的文件到`/path2/`
`/@file/copy/path/path1/file1.mp4&target=/uuid/789456/`	复制`/path1/file1.mp4`路径的文件到按`UUID`为`789456`的目录下

移动文件(夹)

示例操作	含义
`/@file/move/uuid/123456?driver=0&target=/path/path2/`	以`UUID`方式移动`UUID`为`12345`的文件到`/path2/`
`/@file/move/uuid/123456?driver=0&target=/uuid/789456/`	以`UUID`方式移动`UUID`为`12345`的文件到按`UUID`为`789456`的目录下
`/@file/move/path/path1/file1.mp4&target=/path/path2/`	移动`/path1/file1.mp4`路径的文件到`/path2/`
`/@file/move/path/path1/file1.mp4&target=/uuid/789456/`	移动`/path1/file1.mp4`路径的文件到按`UUID`为`789456`的目录下

创建文件(夹)

示例操作	含义
`/@file/create/uuid/123456?driver=0&target=/path/path2/`	以`UUID`方式在`UUID`为`12345`的文件夹下创建`path2`文件夹
`/@file/create/uuid/123456?driver=0&target=/file/file.mp4/`	以`UUID`方式在`UUID`为`12345`的文件夹下创建`file.mp4`文件
`/@file/create/path/path1/&target=/path/path2/`	在`/path1/`路径下创建`path2`文件夹
`/@file/create/path/path1/&target=/file/file.mp4/`	在`/path1/`路径下创建`file.mp4`文件

删除文件(夹)

示例操作	含义
`/@file/remove/uuid/123456?driver=0`	以`UUID`方式删除`UUID`为`12345`的文件
`/@file/remove/path/path1/file1.mp4`	删除`/path1/file1.mp4`路径的文件

配置文件(夹)

示例操作	含义
`/@file/config/uuid/123456?driver=0&config={...}`	以`UUID`方式管理`UUID`为`12345`的文件的元信息，管理内容是`{...}`
`/@file/config/path/path1/file1.mp4?config={...}`	管理`/path1/file1.mp4`路径的文件的元信息，管理内容是`{...}`

分享文件(夹)

示例操作	含义
`/@file/shared/uuid/123456?driver=0&config={...}`	以`UUID`方式创建/管理分享`UUID`为`12345`的文件，分享配置内容是`{...}`
`/@file/shared/path/path1/file1.mp4?config={...}`	创建/管理分享`/path1/file1.mp4`路径的文件，分享配置内容是`{...}`

Request

Path Params

Query Params

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request GET '/@file/list、link、copy、move、remove、create、config、shared/path、uuid、none、file/path1/、0EOJQGLO?target=path2/&driver=0&config={}' \
--form 'files="二进制文件"' \
--form 'config="{...}"'

Responses

🟢200成功

application/json

Body

Example

{}

Modified at 2025-10-21 06:32:03

用户操作接口