# 大会员信息 | BAC Document
社区开源的第三方哔哩哔哩 API 文档

# 大会员信息

## 卡券状态查询

> 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"

查看响应示例：

    {
      "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
      }
    }