大会员福利兑换相关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:
parent
518cf0b368
commit
2f57550ac4
3
.gitignore
vendored
3
.gitignore
vendored
@ -1 +1,2 @@
|
||||
mkdocs/html/*
|
||||
mkdocs/html/*
|
||||
README.md
|
||||
|
||||
@ -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#)
|
||||
@ -3,6 +3,7 @@
|
||||
- [获取用户对应的直播间状态](#获取用户对应的直播间状态)
|
||||
- [获取房间页初始化信息](#获取房间页初始化信息)
|
||||
- [获取主播信息](#获取主播信息)
|
||||
- [批量查询直播间状态](#批量查询直播间状态)
|
||||
|
||||
---
|
||||
|
||||
|
||||
11
live/user.md
11
live/user.md
@ -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
99
user/vip.md
Normal file
@ -0,0 +1,99 @@
|
||||
# 大会员兑换福利
|
||||
|
||||
- [兑换状态查询](#兑换状态查询)
|
||||
- [兑换](#兑换)
|
||||
|
||||
---
|
||||
|
||||
## 兑换状态查询
|
||||
|
||||
> https://api.bilibili.com/x/vip/privilege/my
|
||||
|
||||
*请求方式:GET*
|
||||
|
||||
认证方式:Cookie(SESSDATA)或APP
|
||||
|
||||
**json回复:**
|
||||
|
||||
根对象:
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------- | ---- | -------- | --------------------------- |
|
||||
| code | num | 状态码 | -400:请求错误<br />0:成功 |
|
||||
| message | str | 错误详情 | |
|
||||
| data | obj | 信息本体 | |
|
||||
|
||||
`data`对象:
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----- | -------|----------------|------ |
|
||||
| list | 数组 | 信息本体 | |
|
||||
|
||||
`list`数组:
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----- | -------|-----------------|------ |
|
||||
| 0 | obj | B币兑换状态 | |
|
||||
| 1 | obj | 会员购优惠券兑换状态 | |
|
||||
|
||||
`list内`对象:
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| -------------- | -----|------------------|------ |
|
||||
| type | num | 1 或 2 | 1:B币</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*
|
||||
|
||||
认证方式:Cookie(SESSDATA)
|
||||
注意:请求头中的Origin字段必须为"https://www.bilibili.com/"
|
||||
|
||||
|
||||
**正文参数:**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| ---------- | ---- | ---------- | -------- | ---------------------- |
|
||||
| type | num | 1 或 2 | 必要 | 1:B币</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}"
|
||||
```
|
||||
|
||||
**响应:**
|
||||
无响应
|
||||
Loading…
Reference in New Issue
Block a user