解锁加密相册

POST

/explore/albums/{id}/unlock

输入访问密码解锁加密相册，返回访问令牌。之后请求相册详情、相册图片列表时通过 X-Album-Token 请求头携带。

令牌有效期 120 分钟，相册密码被修改或清除后立即失效

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

密码错误返回 {"status": "error", "message": "访问密码错误"}（HTTP 200）

相册未设置密码返回 {"status": "error", "message": "该相册无需密码访问"}（HTTP 200）

每分钟最多请求 10 次，超出返回 429

请求参数

Path 参数

Header 参数

Body 参数application/json

示例

{
    "password": "1234"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://127.0.0.1:8000/api/v2/explore/albums/1/unlock' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "password": "1234"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "status": "success",
    "message": "successful",
    "data": {
        "token": "eyJpdiI6IjZ2d0F4...",
        "expired_at": "2026-10-23T14:00:00+08:00"
    },
    "time": 1729700000
}

🟠422参数错误

🟠429超出频率限制

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

取消点赞相册

图片详情