设置相册访问密码

PUT

/user/albums/{id}/password

设置相册访问密码，清除密码请使用 DELETE /user/albums/{id}/password。请以响应中的 status 为 success 判断是否保存成功。

密码仅对公开相册生效；设置后访客需输入密码才能查看相册图片，相册中的图片不会出现在广场图片列表、用户主页图片列表和其他公开相册中

密码首尾空白会被去除，全空白视为未填写，返回 422

需要角色组开启 allow_album_password，未开启时返回 {"status": "error", "message": "当前角色组不允许设置相册访问密码"}（HTTP 200）

修改密码后，已签发的访问令牌立即失效

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "password": "1234"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'http://127.0.0.1:8000/api/v2/user/albums/1/password' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
    "password": "1234"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "status": "success",
    "message": "successful",
    "time": 1729700000
}

🟠422参数错误

修改于 2026-10-24 03:22:11

移除标签

清除相册访问密码