大会员信息

卡券状态查询

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(?)

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": 1667231999,
        "vip_type": 2,
        "next_receive_days": 29,
        "period_end_unix": 1667491200
      },
      {
        "type": 2,
        "state": 0,
        "expire_time": 1667231999,
        "vip_type": 2,
        "next_receive_days": 29,
        "period_end_unix": 1667491200
      },
      {
        "type": 3,
        "state": 0,
        "expire_time": 1667231999,
        "vip_type": 2,
        "next_receive_days": 29,
        "period_end_unix": 1667491200
      },
      {
        "type": 4,
        "state": 0,
        "expire_time": 1667231999,
        "vip_type": 2,
        "next_receive_days": 29,
        "period_end_unix": 1667491200
      },
      {
        "type": 5,
        "state": 0,
        "expire_time": 1667231999,
        "vip_type": 2,
        "next_receive_days": 29,
        "period_end_unix": 1667491200
      }
    ],
    "is_short_vip": false,
    "is_freight_open": true
  }
}