# 主题色 | BAC Document
社区开源的第三方哔哩哔哩 API 文档

# 主题色

## 获取主题色基本信息1

> https://club.bilibili.com/api/query.skin.list.do

请求方式：GET

鉴权方式：appkey

认证方式：仅可APP

url参数：

参数名 | 类型 | 内容 | 必要性 | 备注
--- | --- | --- | --- | ---
access_key | str | APP登录Token | APP方式必要 |
appkey | str | APP密钥 | APP方式必要 |
build | num | 版本 | APP方式必要 | 可为`6082000`
sign | str | APP签名 | APP方式必要 |

json回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
ts | num | 当前时间戳 |
code | num | 返回值 | 0：成功 -3：API校验密匙错误 -400：请求错误
data | array | 主题颜色列表 |

`data`数组：

项 | 类型 | 内容 | 备注
--- | --- | --- | ---
0 | obj | 主题颜色1 |
n | obj | 主题颜色(n+1) |
…… | obj | …… | ……

`data`数组中的对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
id | num | 颜色id |
name | str | 颜色名称 |
is_free | bool | 是否免费 | false：收费 true：免费
price | num | 价格 | 单位为硬币
is_bought | bool | 是否已购买 | false：未购买 true：已购买
status | num | 状态 | 1：自动续费 4：已退订
buy_time | num | 购买时间 | 毫秒时间戳
due_time | num | 到期时间 | 毫秒时间戳
color_name | str | 颜色类型名称 |
is_overdue | bool | 是否已到期 | false：未到期 true：已到期

示例：

    curl -G 'https://club.bilibili.com/api/query.skin.list.do' \
    --data-urlencode 'access_key=xxx' \
    --data-urlencode 'appkey=1d8b6e7d45233436' \
    --data-urlencode 'build=6082000' \
    --data-urlencode 'sign=2d37f2cd6f86337a6a07cb3cf311be86'

查看响应示例：

    {
        "ts": 1599225638239,
        "code": 0,
        "data": [
            {
                "id": 2,
                "name": "少女粉",
                "is_free": true,
                "price": 0,
                "is_bought": false,
                "color_name": "pink",
                "is_overdue": false
            },
            {
                "id": 1,
                "name": "夜间模式",
                "is_free": true,
                "price": 0,
                "is_bought": false,
                "color_name": "black",
                "is_overdue": false
            },
            {
                "id": 3,
                "name": "姨妈红",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "color_name": "red",
                "is_overdue": false
            },
            {
                "id": 4,
                "name": "咸蛋黄",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "color_name": "yellow",
                "is_overdue": false
            },
            {
                "id": 5,
                "name": "早苗绿",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "status": 4,
                "buy_time": 1599219782000,
                "due_time": 1601811782000,
                "color_name": "green",
                "is_overdue": false
            },
            {
                "id": 6,
                "name": "胖次蓝",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "color_name": "blue",
                "is_overdue": false
            },
            {
                "id": 7,
                "name": "基佬紫",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "color_name": "purple",
                "is_overdue": false
            }
        ]
    }

## 获取主题色基本信息2

> https://api.bilibili.com/x/garb/skin/color/list

请求方式：GET

认证方式：仅可Cookie

url参数：

参数名 | 类型 | 内容 | 必要性 | 备注
--- | --- | --- | --- | ---
mobi_app | str | 平台标识 | 非必要 | 可为`android`
build | num | 版本 | 非必要 | 可为`6082000`

json回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 | 0：成功 -3：API校验密匙错误 -400：请求错误
message | str | 错误信息 | 默认为0
data | array | 主题颜色列表 |

`data`数组：

项 | 类型 | 内容 | 备注
--- | --- | --- | ---
0 | obj | 主题颜色1 |
n | obj | 主题颜色(n+1) |
…… | obj | …… | ……

`data`数组中的对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
id | num | 颜色id |
name | str | 颜色名称 |
is_free | bool | 是否免费 | false：收费 true：免费
price | num | 价格 | 单位为硬币
is_bought | bool | 是否已购买 | false：未购买 true：已购买
status | num | 状态 | 1：自动续费 4：已退订
buy_time | num | 购买时间 | 毫秒时间戳
due_time | num | 到期时间 | 毫秒时间戳
color_name | str | 颜色类型名称 |
is_overdue | bool | 是否已到期 | false：未到期 true：已到期

示例：

    curl -G 'https://api.bilibili.com/x/garb/skin/color/list' \
    --data-urlencode 'mobi_app=android' \
    --data-urlencode 'build=6082000' \
    -b 'SESSDATA=xxx'

查看响应示例：

    {
        "code": 0,
        "message": "0",
        "ttl": 1,
        "data": [
            {
                "id": 8,
                "name": "简洁白",
                "is_free": true,
                "price": 0,
                "is_bought": false,
                "status": 0,
                "buy_time": 0,
                "due_time": 0,
                "color_name": "white",
                "is_overdue": false
            },
            {
                "id": 2,
                "name": "少女粉",
                "is_free": true,
                "price": 0,
                "is_bought": false,
                "status": 0,
                "buy_time": 0,
                "due_time": 0,
                "color_name": "pink",
                "is_overdue": false
            },
            {
                "id": 1,
                "name": "夜间模式",
                "is_free": true,
                "price": 0,
                "is_bought": false,
                "status": 0,
                "buy_time": 0,
                "due_time": 0,
                "color_name": "black",
                "is_overdue": false
            },
            {
                "id": 3,
                "name": "姨妈红",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "status": 0,
                "buy_time": 0,
                "due_time": 0,
                "color_name": "red",
                "is_overdue": false
            },
            {
                "id": 4,
                "name": "咸蛋黄",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "status": 0,
                "buy_time": 0,
                "due_time": 0,
                "color_name": "yellow",
                "is_overdue": false
            },
            {
                "id": 5,
                "name": "早苗绿",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "status": 4,
                "buy_time": 1599219782000,
                "due_time": 1601811782000,
                "color_name": "green",
                "is_overdue": false
            },
            {
                "id": 6,
                "name": "胖次蓝",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "status": 0,
                "buy_time": 0,
                "due_time": 0,
                "color_name": "blue",
                "is_overdue": false
            },
            {
                "id": 7,
                "name": "基佬紫",
                "is_free": false,
                "price": 5,
                "is_bought": false,
                "status": 0,
                "buy_time": 0,
                "due_time": 0,
                "color_name": "purple",
                "is_overdue": false
            }
        ]
    }