diff --git a/user/vip.md b/user/vip.md index 32fcee7..ce3dbd3 100644 --- a/user/vip.md +++ b/user/vip.md @@ -1,8 +1,8 @@ # 大会员兑换福利 - [大会员兑换福利](#大会员兑换福利) - - [兑换状态查询](#兑换状态查询) - - [兑换](#兑换) + - [卡券状态查询](#卡券状态查询) + - [兑换卡券](#兑换卡券) --- @@ -18,41 +18,41 @@ 根对象: -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | --------------------------- | -| code | num | 返回值 | -101:账号未登录
-400:请求错误
0:成功 | -| message | str | 错误信息 | | -| ttl | num | 1 | | -| data | obj | 信息本体 | | +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|-------------------------------------| +| code | num | 返回值 | -101:账号未登录
-400:请求错误
0:成功 | +| message | str | 错误信息 | | +| ttl | num | 1 | | +| data | obj | 信息本体 | | `data`对象: -| 字段 | 类型 | 内容 | 备注 | -| ----- | -------|----------------|------ | -| list | array | 卡券列表 | | -| is_short_vip | bool | (?) | | -| is_freight_open | bool | (?) | | +| 字段 | 类型 | 内容 | 备注 | +|-----------------|-------|--------|-----| +| list | array | 卡券信息列表 | | +| is_short_vip | bool | (?) | | +| is_freight_open | bool | (?) | | `list`数组: -| 字段 | 类型 | 内容 | 备注 | -| ----- | -------|-----------------|------ | -| 0 | obj | B币兑换状态 | | -| 1 | obj | 会员购优惠券兑换状态 | | -| 2 | obj | 漫画福利券兑换状态 | | -| 3 | obj | 会员购运费券兑换状态 | | +| 字段 | 类型 | 内容 | 备注 | +|-----|-----|-------------|-----| +| 0 | obj | B币兑换状态 | | +| 1 | obj | 会员购优惠券兑换状态 | | +| 2 | obj | 漫画福利券兑换状态 | | +| 3 | obj | 会员购包邮券兑换状态 | | +| 4 | obj | 漫画商城优惠券兑换状态 | | `list`中的对象: -| 字段 | 类型 | 内容 | 备注 | -| -------------- | -----|------------------|------ | -| type | num | 卡券类型 | 1:B币
2:会员购优惠券
3:漫画福利券
4:会员购运费券 | -| state | num | 兑换状态 | 0:当月未兑换
1:已兑换 | -| expire_time | num | 当月过期时间 | 当月月底 | -| vip_type | num | | 2:年度大会员可兑换 | -| next_receive_days | num | 距下一轮兑换剩余天数 | | -| period_end_unix | num | 距下一轮兑换截止时间戳 | 秒级时间戳 | - +| 字段 | 类型 | 内容 | 备注 | +|-------------------|-----|------------|--------------------------------------------------------------| +| 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 | 下一轮兑换开始时间戳 | 秒级时间戳 | **示例:** @@ -66,62 +66,62 @@ curl -G 'http://api.bilibili.com/x/vip/privilege/my' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [ - { - "type": 1, - "state": 1, - "expire_time": 1651334399, - "vip_type": 2, - "next_receive_days": 20, - "period_end_unix": 1651420800 - }, - { - "type": 2, - "state": 0, - "expire_time": 1651334399, - "vip_type": 2, - "next_receive_days": 20, - "period_end_unix": 1651420800 - }, - { - "type": 3, - "state": 1, - "expire_time": 1651334399, - "vip_type": 2, - "next_receive_days": 20, - "period_end_unix": 1651420800 - }, - { - "type": 4, - "state": 0, - "expire_time": 1651334399, - "vip_type": 2, - "next_receive_days": 20, - "period_end_unix": 1651420800 - }, - { - "type": 5, - "state": 0, - "expire_time": 1651334399, - "vip_type": 2, - "next_receive_days": 20, - "period_end_unix": 1651420800 - } - ], - "is_short_vip": false, - "is_freight_open": true - } + "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* @@ -130,20 +130,20 @@ curl -G 'http://api.bilibili.com/x/vip/privilege/my' \ **正文参数:** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ---------- | -------- | ---------------------- | -| type | num | 兑换类型 | 必要 | 1:B币
2:会员购优惠券
3:漫画福利券
4:会员购运费券 | -| csrf | num | CSRF token | 必要 | Cookie bili_jct字段 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +|------|-----|------------|-----|--------------------------------------------------------------| +| 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 | | +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|---------------------------------------------------------------------------------------------------| +| code | num | 返回值 | -101:账号未登录
-111:csrf 校验失败
-400:请求错误
69800:网络繁忙 请稍后再试
69801:你已领取过该权益
0:成功 | +| message | str | 错误信息 | | +| ttl | num | 1 | | **示例:** @@ -159,9 +159,9 @@ curl 'http://api.bilibili.com/x/vip/privilege/receive' \ ```json { - "code": 0, - "message": "0", - "ttl": 1 + "code": 0, + "message": "0", + "ttl": 1 } ```