修正大会员兑换 api (#294)
* 修正大会员兑换 api * 修正大会员兑换 api (#293) * 补完 api 示例 * 统一写作 http * 修正【大会员权益】文档格式 Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
This commit is contained in:
topkie
92
user/vip.md
92
user/vip.md
@@ -6,7 +6,7 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 兑换状态查询
|
## 卡券状态查询
|
||||||
|
|
||||||
> http://api.bilibili.com/x/vip/privilege/my
|
> http://api.bilibili.com/x/vip/privilege/my
|
||||||
|
|
||||||
@@ -20,15 +20,16 @@
|
|||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ------- | ---- | -------- | --------------------------- |
|
| ------- | ---- | -------- | --------------------------- |
|
||||||
| code | num | 状态码 | -400：请求错误<br />0：成功 |
|
| code | num | 返回值 | -101：账号未登录<br />-400：请求错误<br />0：成功 |
|
||||||
| message | str | 错误详情 | |
|
| message | str | 错误信息 | |
|
||||||
|
| ttl | num | 1 | |
|
||||||
| data | obj | 信息本体 | |
|
| data | obj | 信息本体 | |
|
||||||
|
|
||||||
`data`对象：
|
`data`对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ----- | -------|----------------|------ |
|
| ----- | -------|----------------|------ |
|
||||||
| list | 数组 | 信息本体 | |
|
| list | array | 卡券列表 | |
|
||||||
|
|
||||||
`list`数组：
|
`list`数组：
|
||||||
|
|
||||||
@@ -37,19 +38,21 @@
|
|||||||
| 0 | obj | B币兑换状态 | |
|
| 0 | obj | B币兑换状态 | |
|
||||||
| 1 | obj | 会员购优惠券兑换状态 | |
|
| 1 | obj | 会员购优惠券兑换状态 | |
|
||||||
|
|
||||||
`list内`对象：
|
`list`中的对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| -------------- | -----|------------------|------ |
|
| -------------- | -----|------------------|------ |
|
||||||
| type | num | 1 或 2 | 1：B币</br>2：会员购优惠券 |
|
| type | num | 卡券类型 | 1：B币<br />2：会员购优惠券<br />3：漫画福利券 |
|
||||||
| status | num | 兑换状态 | 0：当月未兑换</br>1：已兑换 |
|
| state | num | 兑换状态 | 0：当月未兑换<br />1：已兑换 |
|
||||||
| expire_time | num | 当月过期时间 | 当月月底 |
|
| expire_time | num | 当月过期时间 | 当月月底 |
|
||||||
|
| vip_type | num | (?) | |
|
||||||
|
|
||||||
|
|
||||||
**示例：**
|
**示例：**
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
|
curl -G 'http://api.bilibili.com/x/vip/privilege/my' \
|
||||||
|
-b "SESSDATA=xxx"
|
||||||
```
|
```
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
@@ -57,15 +60,31 @@ curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
|
|||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"code":0,
|
"code": 0,
|
||||||
"message":"0",
|
"message": "0",
|
||||||
"ttl":1,
|
"ttl": 1,
|
||||||
"data":{
|
"data": {
|
||||||
"list":[
|
"list": [
|
||||||
{"type":1,"state":1,"expire_time":1638287999},
|
{
|
||||||
{"type":2,"state":1,"expire_time":1638287999}
|
"type": 1,
|
||||||
]
|
"state": 1,
|
||||||
}
|
"expire_time": 1640966399,
|
||||||
|
"vip_type": 2
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": 2,
|
||||||
|
"state": 1,
|
||||||
|
"expire_time": 1640966399,
|
||||||
|
"vip_type": 2
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": 3,
|
||||||
|
"state": 0,
|
||||||
|
"expire_time": 1640966399,
|
||||||
|
"vip_type": 2
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -73,28 +92,47 @@ curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
|
|||||||
|
|
||||||
|
|
||||||
## 兑换
|
## 兑换
|
||||||
> http://api.bilibili.com/x/vip/privilege/my
|
> http://api.bilibili.com/x/vip/privilege/receive
|
||||||
|
|
||||||
*请求方式:POST*
|
*请求方式:POST*
|
||||||
|
|
||||||
认证方式：Cookie（SESSDATA）
|
认证方式：Cookie(SESSDATA)
|
||||||
注意：请求头中的Origin字段必须为"https://www.bilibili.com/"
|
|
||||||
|
|
||||||
|
|
||||||
**正文参数：**
|
**正文参数：**
|
||||||
|
|
||||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
| ---------- | ---- | ---------- | -------- | ---------------------- |
|
| ---------- | ---- | ---------- | -------- | ---------------------- |
|
||||||
| type | num | 1 或 2 | 必要 | 1：B币</br>2：会员购优惠券 |
|
| type | num | 兑换类型 | 必要 | 1：B币<br />2：会员购优惠券<br />3：漫画福利券 |
|
||||||
| csrf | num | CSRF token | 必要 | Cookie bili_jct字段 |
|
| csrf | num | CSRF token | 必要 | Cookie bili_jct字段 |
|
||||||
|
|
||||||
|
**json回复：**
|
||||||
|
|
||||||
|
根对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ------- | ---- | -------- | ------------------------------------------------------------ |
|
||||||
|
| code | num | 返回值 | -101：账号未登录<br />-111：csrf 校验失败<br />-400：请求错误<br />69800：网络繁忙 请稍后再试<br />69801：你已领取过该权益<br />0：成功 |
|
||||||
|
| message | str | 错误信息 | |
|
||||||
|
| ttl | num | 1 | |
|
||||||
|
|
||||||
**示例：**
|
**示例：**
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
|
curl 'http://api.bilibili.com/x/vip/privilege/receive' \
|
||||||
-H "Origin: https://www.bilibili.com/" \
|
-b 'SESSDATA=xxx' \
|
||||||
-d "{\"type\": 1, \"csrf\": csrf_token}"
|
--data-urlencode 'type=1' \
|
||||||
|
--data-urlencode 'csrf=csrf_token'
|
||||||
```
|
```
|
||||||
|
|
||||||
**响应：**
|
<details>
|
||||||
无响应
|
<summary>查看响应示例：</summary>
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 0,
|
||||||
|
"message": "0",
|
||||||
|
"ttl": 1
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|||||||
Reference in New Issue
Block a user