GET/api/v3/album_list

获取相册列表

读取当前账号下的全部相册，用于上传时指定 album_id。

接口信息

项目	说明
接口地址	`GET /api/v3/album_list`
请求类型	`GET`
鉴权	`Authorization: Bearer sk-xxx`

请求头

字段	值格式	必填	说明
Authorization	`Bearer <token>`	是	开放接口 Token，在控制台 → 开放接口获取，`sk-` 开头

请求参数

无。当前版本不支持分页或过滤，一次返回全部相册。

请求示例

curl --location --request GET 'https://www.imgurl.org/api/v3/album_list' \
--header 'Authorization: Bearer sk-xxx'

成功响应

{
  "code": 200,
  "msg": "success",
  "data": {
    "items": [
      {
        "album_id": 1,
        "name": "测试相册",
        "slug": "qD6fDt",
        "description": "测试相册",
        "created_at": "2026-01-08 12:20:40"
      }
    ]
  }
}

字段	类型	说明
album_id	int	相册 ID，上传时传给 `params.album_id`
name	string	相册名称
slug	string	相册短标识（6 位大小写字母 + 数字）
description	string	相册描述，可能为空
created_at	string	创建时间，格式 `YYYY-MM-DD HH:mm:ss`

没有相册时 items 为空数组；默认相册（album_id = 0）不会出现在列表里。

失败响应

{
  "code": -1000,
  "msg": "invalid.token",
  "data": null
}

code 不为 200 时按 msg 判断原因，完整错误码见总览。