bilibili-API-collect/user/vip.md

大会员兑换福利

• 大会员兑换福利
  • 卡券状态查询
  • 兑换卡券

---

卡券状态查询

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

请求方式:GET

认证方式：Cookie（SESSDATA）或APP

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	-101：账号未登录 -400：请求错误 0：成功
message	str	错误信息
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
list	array	卡券信息列表
is_short_vip	bool	(?)
is_freight_open	bool	(?)

list数组：

字段	类型	内容	备注
0	obj	B币兑换状态
1	obj	会员购优惠券兑换状态
2	obj	漫画福利券兑换状态
3	obj	会员购包邮券兑换状态
4	obj	漫画商城优惠券兑换状态

list中的对象：

字段	类型	内容	备注
type	num	卡券类型	1：B币券 2：会员购优惠券 3：漫画福利券 4：会员购包邮券 5：漫画商城优惠券
state	num	兑换状态	0：当月未兑换 1：已兑换
expire_time	num	本轮卡券过期时间戳	当月月底
vip_type	num		2：年度大会员可兑换
next_receive_days	num	距下一轮兑换剩余天数
period_end_unix	num	下一轮兑换开始时间戳	秒级时间戳

示例：

curl -G 'http://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
  }
}

兑换卡券

http://api.bilibili.com/x/vip/privilege/receive

请求方式:POST

认证方式：Cookie(SESSDATA)

正文参数：

参数名	类型	内容	必要性	备注
type	num	兑换类型	必要	1：B币券 2：会员购优惠券 3：漫画福利券 4：会员购包邮券 5：漫画商城优惠券
csrf	num	CSRF token	必要	Cookie bili_jct字段

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	-101：账号未登录 -111：csrf 校验失败 -400：请求错误 69800：网络繁忙 请稍后再试 69801：你已领取过该权益 0：成功
message	str	错误信息
ttl	num	1

示例：

curl 'http://api.bilibili.com/x/vip/privilege/receive' \
-b 'SESSDATA=xxx' \
--data-urlencode 'type=1' \
--data-urlencode 'csrf=csrf_token'

查看响应示例：

{
  "code": 0,
  "message": "0",
  "ttl": 1
}