社区版API

创建分享

开发中

POST

/share

最后修改时间：2024-05-16 09:30:26

密码：若不想设置请传递空字符串

自动过期：downloads和expire必须同时开启。若不需要开启，请设置downloads的值为-1。expire设置为0或负数会导致分享立即过期。

请求参数

Cookie 参数

cloudreve-session

string

鉴权session

可选

默认值:

Body 参数application/json

string

分享的文件ID

必需

is_dir

boolean

是否为文件夹

必需

password

string

必需

若要设置密码则填写，否则空串

downloads

integer

必需

多少次下载后自动过期，设置为-1时自动过期不生效（即使同时设置了expire）

expire

integer

必需

过期时间（自现在开始经过多少秒），若downloads为-1则不生效

preview

boolean

是否允许预览

必需

示例

{
  "id": "dmLxcN",
  "is_dir": false,
  "password": "",
  "downloads": -1,
  "expire": 86400,
  "preview": true
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1:5212/api/v3/share' \
--header 'Cookie: cloudreve-session=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "dmLxcN",
    "is_dir": false,
    "password": "",
    "downloads": -1,
    "expire": 86400,
    "preview": true
}'

返回响应

🟢200成功

application/json

Body

code

integer

响应状态

必需

data

string

分享链接

必需

msg

string

错误信息

必需

示例

{
  "code": 0,
  "data": "string",
  "msg": "string"
}

修改于 2024-05-16 09:30:26

获取文件外链

当前用户的WebDAV账户