大会员信息

卡券状态查询

https://api.bilibili.com/x/vip/privilege/my

请求方式:GET

认证方式:Cookie (SESSDATA) / access_key

json回复:

根对象:

字段类型内容备注
codenum返回值-101:账号未登录
-400:请求错误
0:成功
messagestr错误信息
ttlnum1
dataobj信息本体

data对象:

字段类型内容备注
listarray卡券信息列表
is_short_vipbool(?)
is_freight_openbool(?)
levelnum当前等级
cur_expnum当前拥有经验值
next_expnum升级所需经验值满级时为 -1
is_vipbool是否为大会员
is_senior_membernum是否为硬核会员
format060102num(?)格式为YYMMDD,意义不明
is_overdue_vipbool大会员是否过期
vip_statusnum会员状态0:无
1:有
vip_typenum会员类型0:无
1:月大会员
2:年度及以上大会员
keeptime_endnum大会员当前阶段过期时间秒级时间戳
vip_due_datenum大会员过期时间秒级时间戳
vip_is_annualbool是否为年度及以上大会员
vip_is_monthbool是否为月大会员
vip_is_new_userbool是否为大会员新用户
bind_phonestr绑定的手机号星号隐藏部分信息
taobao_account有效时:obj
无效时:null
绑定的淘宝账号

list数组中的对象:

索引类型内容type备注
0objB币兑换状态1
1obj会员购优惠券兑换状态2
2obj漫画福利券兑换状态3
3obj会员购包邮券兑换状态4
4obj漫画商城优惠券兑换状态5
5obj装扮体验卡兑换状态6
6obj课堂优惠券兑换状态7
7obj王者荣耀)游戏礼盒兑换状态8每日可领取,目前 state 固定为 1
8obj每日 10 经验领取状态9每日可领取,未完成时 state 为 2

list中的对象:

字段类型内容备注
typenum卡券类型详见 list 数组表格中的 type
statenum兑换状态0:未兑换
1:已兑换
2:未完成(若需要完成)
expire_timenum本轮卡券过期时间戳当月月底/当日24点
vip_typenum当前用户的大会员状态2:年度大会员
next_receive_daysnum距下一轮兑换剩余天数无权限时,每月任务固定为 0,每日固定为 1
period_end_unixnum下一轮兑换开始时间戳秒级时间戳

注意:

卡券除每日可领取(type89)的,其他可通过 https://api.bilibili.com/x/vip/privilege/receive 领取

每日 10 经验领取(type9)需要完成视频观看,未完成的 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
  }
}