主题色
获取主题色基本信息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'
查看响应示例:
```json
{
"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'
查看响应示例:
```json
{
"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
}
]
}
```