Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ad7fe656f7
bilibili-API-collect/docs/vip/info.md
晨叶梦春 0c9c2da126 fix #1161
2025-04-20 16:52:31 +08:00

13 KiB
Raw Blame History

大会员信息

卡券状态查询

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