Skip to content

分享 ​

分享链接可指向单张图片或整个相册,支持可选的访问密码、有效期(小时)与最大访问次数。

方法路径说明
POST/shares创建分享(体见下)
GET/shares当前账号创建的分享
DELETE/shares/{id}撤销分享
GET/shares/{token}分享公开信息(无需登录,用于判断是否需要密码)
POST/shares/{token}/access校验密码并返回内容(无需登录)

创建请求体示例:

json
{
  "target_type": "image",
  "target_id": "<image_id 或 album_id>",
  "password": "可选",
  "expires_in_hours": 24,
  "max_views": 100
}

target_type 取值为 image 或 album。password 为空表示无需密码;expires_in_hours 与 max_views 为 0 或省略表示不限制。访问受密码保护的分享时,POST /shares/{token}/access 需在请求体携带 {"password":"…"}。加密分享通过角色组的 share 与 share_password 功能开关控制。分享的公开页面为 /s/{token}。

基于 MIT 许可证发布