大会员福利兑换相关API (SocialSisterYi#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

.gitignore

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

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#) 

live/info.md

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

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

user/vip.md

@@ -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}" 
+```
+
+**响应：**
+无响应