大会员信息
卡券状态查询
https://api.bilibili.com/x/vip/privilege/my
请求方式:GET
认证方式:Cookie (SESSDATA) / access_key
json回复:
根对象:
| 字段 |
类型 |
内容 |
备注 |
| code |
num |
返回值 |
-101:账号未登录 -400:请求错误 0:成功 |
| message |
str |
错误信息 |
|
| ttl |
num |
1 |
|
| data |
obj |
信息本体 |
|
data对象:
| 字段 |
类型 |
内容 |
备注 |
| list |
array |
卡券信息列表 |
|
| is_short_vip |
bool |
(?) |
|
| is_freight_open |
bool |
(?) |
|
| level |
num |
当前等级 |
|
| cur_exp |
num |
当前拥有经验值 |
|
| next_exp |
num |
升级所需经验值 |
满级时为 -1 |
| is_vip |
bool |
是否为大会员 |
|
| is_senior_member |
num |
是否为硬核会员 |
|
| format060102 |
num |
(?) |
格式为YYMMDD,意义不明 |
| is_overdue_vip |
bool |
大会员是否过期 |
|
| vip_status |
num |
会员状态 |
0:无 1:有 |
| vip_type |
num |
会员类型 |
0:无 1:月大会员 2:年度及以上大会员 |
| keeptime_end |
num |
大会员当前阶段过期时间 |
秒级时间戳 |
| vip_due_date |
num |
大会员过期时间 |
秒级时间戳 |
| vip_is_annual |
bool |
是否为年度及以上大会员 |
|
| vip_is_month |
bool |
是否为月大会员 |
|
| vip_is_new_user |
bool |
是否为大会员新用户 |
|
| bind_phone |
str |
绑定的手机号 |
星号隐藏部分信息 |
| taobao_account |
有效时:obj 无效时:null |
绑定的淘宝账号 |
|
list数组:
| 索引 |
类型 |
内容 |
type |
备注 |
| 0 |
obj |
B币兑换状态 |
1 |
|
| 1 |
obj |
会员购优惠券兑换状态 |
2 |
|
| 2 |
obj |
漫画福利券兑换状态 |
3 |
|
| 3 |
obj |
会员购包邮券兑换状态 |
4 |
|
| 4 |
obj |
漫画商城优惠券兑换状态 |
5 |
|
| 5 |
obj |
装扮体验卡兑换状态 |
6 |
|
| 6 |
obj |
课堂优惠券兑换状态 |
7 |
|
| 7 |
obj |
(王者荣耀)游戏礼盒兑换状态 |
8 |
每日可领取,目前 state 固定为 1 |
| 8 |
obj |
每日 10 经验领取状态 |
9 |
每日可领取,未完成时 state 为 2 |
list数组中的对象:
| 字段 |
类型 |
内容 |
备注 |
| type |
num |
卡券类型 |
详见 list 数组表格中的 type 项 |
| state |
num |
兑换状态 |
0:未兑换 1:已兑换 2:未完成(若需要完成) |
| expire_time |
num |
本轮卡券过期时间戳 |
当月月底/当日24点 |
| vip_type |
num |
当前用户的大会员状态 |
2:年度大会员 |
| next_receive_days |
num |
距下一轮兑换剩余天数 |
无权限时,每月任务固定为 0,每日固定为 1 |
| period_end_unix |
num |
下一轮兑换开始时间戳 |
秒级时间戳 |
注意:
卡券除每日可领取(type 为 8 和 9)的,其他可通过 https://api.bilibili.com/x/vip/privilege/receive 领取
每日 10 经验领取(type 为 9)需要完成视频观看,未完成的 state 为 2。
示例:
curl 'https://api.bilibili.com/x/vip/privilege/my' \
-b "SESSDATA=xxx"
查看响应示例:
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"type": 1,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "59534,45476",
"hit_value": 2
},
"extra_params": null
},
{
"type": 2,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 3,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 4,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 5,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 6,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 7,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 14,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "59534,45476",
"hit_value": 2
},
"extra_params": null
},
{
"type": 15,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 16,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 17,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 18,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 0,
"period_end_unix": 0,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 1,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 19,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 0,
"period_end_unix": 0,
"is_count": false,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 1,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": {
"is_allowe_receive": "true",
"is_show": "true",
"last_salary_time": "0",
"now": "1745138836"
}
},
{
"type": 20,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 0,
"period_end_unix": 0,
"is_count": false,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 1,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": {
"is_allowe_receive": "false",
"is_show": "false",
"last_salary_time": "0",
"now": "1745138836"
}
},
{
"type": 8,
"state": 1,
"expire_time": 1745164800,
"vip_type": 2,
"next_receive_days": 1,
"period_end_unix": 1745164800,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 2,
"salary_type": 1,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 9,
"state": 0,
"expire_time": 1745164800,
"vip_type": 2,
"next_receive_days": 1,
"period_end_unix": 1745164800,
"is_count": false,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
}
],
"is_short_vip": false,
"is_freight_open": true,
"level": 6,
"cur_exp": 34424,
"next_exp": -1,
"is_vip": true,
"is_senior_member": 1,
"format060102": 250418,
"is_overdue_vip": false,
"vip_status": 1,
"vip_type": 2,
"keeptime_end": 1747584000,
"vip_due_date": 1832083200,
"vip_is_annual": true,
"vip_is_month": false,
"vip_is_new_user": false,
"bind_phone": "138****0000",
"taobao_account": null
}
}
```