大会员福利兑换相关API (#269)

* Update info.md

* Update info.md

* Update info.md

* Update info.md

* Update info.md

* Update info.md

* add user api under live folder

* Update info.md

* Update user.md

* test index

* text index

* Update README.md

* text indexs

* update indexs

* update Index

* update index

* update index

* update index

* update index

* update index

* 稍微建设了一下目录

* 稍微建设了一下目录

* add vip

* 添加大会员福利兑换相关API
This commit is contained in:
Tyrael 2021-11-14 20:04:25 +11:00 committed by GitHub
parent 518cf0b368
commit 2f57550ac4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 113 additions and 4 deletions

3
.gitignore vendored
View File

@ -1 +1,2 @@
mkdocs/html/*
mkdocs/html/*
README.md

View File

@ -68,6 +68,7 @@ PS所有http协议地址均可使用https文档中为了统一写作`http`
- [个人空间](user/space.md)x
- [检查昵称是否可注册](user/check_nickname.md)√
- [用户注册](user/register.md)
- [大会员福利兑换](user/vip.md)
- [视频](video)
- [视频分区一览(分区代码)](video/video_zone.md)√
- [基本信息](video/info.md)√
@ -281,4 +282,4 @@ B站空间<https://space.bilibili.com/293793435>
- [uw-labs/bloomrpc](https://github.com/uw-labs/bloomrpc): GUI Client for GRPC Services
- [grpc/grpc](https://github.com/grpc/grpc): The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
- [grpc/grpc](https://github.com/grpc/grpc): The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)

View File

@ -3,6 +3,7 @@
- [获取用户对应的直播间状态](#获取用户对应的直播间状态)
- [获取房间页初始化信息](#获取房间页初始化信息)
- [获取主播信息](#获取主播信息)
- [批量查询直播间状态](#批量查询直播间状态)
---

View File

@ -120,6 +120,13 @@
| mobile_verify | num | | |
| official_verify | obj | 认证信息 | |
**示例:**
```shell
curl https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal \
-b "SESSDATA=xxx"
```
<details>
<summary>查看响应示例:</summary>
@ -133,7 +140,7 @@
"count": 19,
"fansMedalList": [
{
"uid": 3831650,
"uid": 1,
"target_id": 3821157,
"medal_id": 283582,
"score": 16031,
@ -206,7 +213,7 @@
"roomid": 21692711
}
],
"name": "藍地球",
"name": "xxx",
"pageinfo": {
"totalpages": 2,
"curPage": 2

99
user/vip.md Normal file
View File

@ -0,0 +1,99 @@
# 大会员兑换福利
- [兑换状态查询](#兑换状态查询)
- [兑换](#兑换)
---
## 兑换状态查询
> https://api.bilibili.com/x/vip/privilege/my
*请求方式:GET*
认证方式CookieSESSDATA或APP
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 状态码 | -400请求错误<br />0成功 |
| message | str | 错误详情 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----- | -------|----------------|------ |
| list | 数组 | 信息本体 | |
`list`数组:
| 字段 | 类型 | 内容 | 备注 |
| ----- | -------|-----------------|------ |
| 0 | obj | B币兑换状态 | |
| 1 | obj | 会员购优惠券兑换状态 | |
`list内`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------------- | -----|------------------|------ |
| type | num | 1 或 2 | 1B币</br>2会员购优惠券 |
| status | num | 兑换状态 | 0当月未兑换</br>1已兑换 |
| expire_time | num | 当月过期时间 | 当月月底 |
**示例:**
```shell
curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"list":[
{"type":1,"state":1,"expire_time":1638287999},
{"type":2,"state":1,"expire_time":1638287999}
]
}
}
```
</details>
## 兑换
> https://api.bilibili.com/x/vip/privilege/my
*请求方式:POST*
认证方式CookieSESSDATA
注意请求头中的Origin字段必须为"https://www.bilibili.com/"
**正文参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------- | -------- | ---------------------- |
| type | num | 1 或 2 | 必要 | 1B币</br>2会员购优惠券 |
| csrf | num | CSRF token | 必要 | Cookie bili_jct字段 |
**示例:**
```shell
curl -G 'https://api.bilibili.com/x/vip/privilege/my' \
-H "Origin: https://www.bilibili.com/" \
-d "{\"type\": 1, \"csrf\": csrf_token}"
```
**响应:**
无响应