+
+- [获取音频流URL（无法获取付费音频）（web端）](#获取音频流url无法获取付费音频web端)
+- [获取音频流URL（可获取付费音频）（双端）](#获取音频流url可获取付费音频双端)
+- [音频流的获取](#音频流的获取)
+
+---
+
+音质`qn`参数：
+
+| 代码 | 含义 |
+| ---- | -------------------- |
+| 0 | 流畅 128K |
+| 1 | 标准 192K |
+| 2 | 高品质 320K |
+| 3 | 无损 FLAC （大会员） |
+
+## 获取音频流URL（无法获取付费音频）（web端）
+
+> https://www.bilibili.com/audio/music-service-c/web/url
+
+*请求方式：GET*
+
+**注：web端无法播放完整付费歌曲，付费歌曲为30s试听片段**
+
+本接口仅能获取192K音质的音频
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------ | ---- |
+| sid | num | 音频auid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | -------- | ----------------------------------------------------------- |
+| code | num | 返回值 | 0:成功
+
+评论系统为全站通用，且APP与web端接口共用，以type标明对象类型，以oid指向响应的对象id
+
+---
+
+**继续查看：**
+
+- [查询类](list.md)
+- [操作类](action.md)
+
+## 评论区类型代码
+
+（PS：以下部分内容来源不明，有待验证）
+
+| 代码 | 评论区类型 | oid 的意义 |
+| ---- | ----------------------- | ----------- |
+| 1 | 视频稿件 | 稿件 avid |
+| 2 | 话题 | 话题 id |
+| 4 | 活动 | 活动 id |
+| 5 | 小视频 | 小视频 id |
+| 6 | 小黑屋封禁信息 | 封禁公示 id |
+| 7 | 公告信息 | 公告 id |
+| 8 | 直播活动 | 直播间 id |
+| 9 | 活动稿件 | (?) |
+| 10 | 直播公告 | (?) |
+| 11 | 相簿（图片动态） | 相簿 id |
+| 12 | 专栏 | 专栏 cvid |
+| 13 | 票务 | (?) |
+| 14 | 音频 | 音频 auid |
+| 15 | 风纪委员会 | 众裁项目 id |
+| 16 | 点评 | (?) |
+| 17 | 动态（纯文字动态&分享） | 动态 id |
+| 18 | 播单 | (?) |
+| 19 | 音乐播单 | (?) |
+| 20 | 漫画 | (?) |
+| 21 | 漫画 | (?) |
+| 22 | 漫画 | 漫画 mcid |
+| 33 | 课程 | 课程 epid |
+
+## 评论条目对象
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------- | ------------------------------- | ------------------ | ------------------------------------------------------------ |
+| rpid | num | 评论 rpid | |
+| oid | num | 评论区对象 id | |
+| type | num | 评论区类型代码 | **类型代码见上表** |
+| mid | num | 发送者 mid | |
+| root | num | 根评论 rpid | 若为一级评论则为 0
+
+**注：以前充电是电池的概念，1B币折合10电池，一般地充电10电池可获得1经验**
+
+**目前（2020/12/02后）则是贝壳的概念，1B币折合1贝壳、1经验（如果存在小数点，则经验值向下取整，即2.5B币获得2经验）**
+
+---
+
+- [B币方式充电](#b币方式充电)
+ - [新版本B币充电](#新版本b币充电)
+ - [老版本B币充电](#老版本b币充电)
+
+---
+
+## 新版本B币充电
+
+> https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| -------- | ---- | ------------------------ | ------ | ------------------------------------------------- |
+| bp_num | num | 贝壳数量 | 必要 | 必须在2-9999之间 |
+| is_bp_remains_prior | bool | 是否优先扣除B币余额 | 必要 | [true,false]，B币充电请选择true |
+| up_mid | num | 充电对象用户mid | 必要 | |
+| otype | str | 充电来源 | 必要 | up：空间充电
+
+- [视频添加稍后再看](#视频添加稍后再看)
+- [添加频道中所有视频到稍后再看](#添加频道中所有视频到稍后再看)
+- [获取稍后再看视频列表](#获取稍后再看视频列表)
+- [删除稍后再看视频](#删除稍后再看视频)
+- [清空稍后再看视频列表](#清空稍后再看视频列表)
+
+---
+
+## 视频添加稍后再看
+
+>https://api.bilibili.com/x/v2/history/toview/add
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+最多添加100个视频
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------------ | ------------------ |
+| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
+
+- [扫码登录流程(伪代码)](#扫码登录流程伪代码)
+- [web端扫码登录](#web端扫码登录)
+ - [申请二维码(web端)](#申请二维码web端)
+ - [扫码登录(web端)](#扫码登录web端)
+- [web端扫码登录-旧版](#web端扫码登录-旧版)
+ - [申请二维码(web端-旧版)](#申请二维码web端-旧版)
+ - [扫码登录(web端-旧版)](#扫码登录web端-旧版)
+- [TV端扫码登录](#TV端扫码登录)
+ - [申请二维码(TV端)](#申请二维码TV端)
+ - [扫码登录(TV端)](#扫码登录TV端)
+
+---
+
+## 扫码登录流程(伪代码)
+
+```python
+token, url = 申请二维码()
+生成二维码(url) # 等待客户端扫码
+while True:
+ status, cookie = 扫码登录(token)
+ match status:
+ case 未扫描:
+ continue
+ case 二维码超时 | 二维码失效:
+ 提示('二维码失效或超时') # 需要用户重新操作
+ break
+ case 已扫描未确认:
+ 提示('扫描成功')
+ case 登录成功:
+ 提示('扫描成功')
+ 存储cookie(cookie)
+ SSO登录页面跳转()
+ break
+```
+
+## web端扫码登录
+
+### 申请二维码(web端)
+
+> https://passport.bilibili.com/x/passport-login/web/qrcode/generate
+
+*请求方式：GET*
+
+密钥超时为180秒
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|------|
+| code | num | 返回值 | 0：成功 |
+| message | str | 错误信息 | |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|------------|-----|------------------|--------|
+| url | str | 二维码内容 (登录页面 url) | |
+| qrcode_key | str | 扫码登录秘钥 | 恒为32字符 |
+
+**示例：**
+
+`url`中的值生成二维码，等待手机客户端扫描，并将`qrcode_key`保存备用
+
+```shell
+curl 'https://passport.bilibili.com/x/passport-login/web/qrcode/generate'
+```
+
+1：已开通 | +| show_state | num | | | +| expire_date | str | 轻享卡到期时间 | | +| receive_amount | num | 已领取数量 | | +| save_money | num | 已节省漫币 | | +| index | num | 默认选择签到周期 | | +| week | array | 一个领取周期内的领取状态信息 | | +| month_reward_state | num | 是否可选择全勤奖 | 0：不可领取
1：可领取
2：不可领取（灰色） | +| month_reward | num | | | +| cur_month_end | str | 全勤奖领取剩余时间 | | +| server_time | str | 当前服务器时间 | | + +`week`数组中的对象： + +| 字段名 | 类型 | 内容 | 备注 | +|-------------------|-----|-------------|------------------------------------------------| +| index | num | 第几领取周期 | 从`1`开始 | +| start_time | str | 本周期领取开始时间 | 1：待领取
2：已领取
3：明日可领
4：已失效
5：可领取 | +| end_time | str | 本周期领取结束时间 | `同上` | +| first | num | 本周期第1天的领取状态 | `同上` | +| second | num | 本周期第2天的领取状态 | `同上` | +| third | num | 本周期第3天的领取状态 | `同上` | +| fourth | num | 本周期第4天的领取状态 | `同上` | +| full_reward_state | num | 周期全勤奖领取状态 | 1：不可领取
2:可领取
3：已领取 | + +**示例：** + +`SESSDATA`方式： + +```shell +curl -L -X POST 'https://manga.bilibili.com/twirp/card.v1.Card/GetUserLightCard' \ +-H 'Cookie: SESSDATA=xxx' +``` + +`access_key`方式： + +```shell +curl -L -X POST 'https://manga.bilibili.com/twirp/card.v1.Card/GetUserLightCard?access_key=xxx' +``` + +
+
+
+# 领取轻享卡奖励
+
+> https://manga.bilibili.com/twirp/card.v1.Card/GetLightCoupon
+
+*请求方式：POST*
+
+是否需要登录：`是`
+
+认证方式：Cookie（SESSDATA）/ APP
+
+Content-Type：`application/json`
+
+**URL参数：**
+
+| 参数名 | 类型 | 必填 | 内容 | 备注 |
+|------------|-----|----|-----------------|----|
+| access_key | str | | 与`SESSDATA`二选其一 | |
+
+**正文参数（ application/json ）：**
+
+| 参数名 | 类型 | 必填 | 内容 | 备注 |
+|-----------|-----|----|-----|--------|
+| weekIndex | num | √ | 第几周 | 从`1`开始 |
+| type | num | √ | 第几天 | 从`1`开始 |
+
+**json回复：**
+
+根对象：
+
+| 字段名 | 类型 | 内容 | 备注 |
+|------|-----|-----|----------------------------------------------------|
+| code | num | 响应码 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "msg": "", + "data": { + "state": 1, + "show_state": 1, + "expire_date": "2023-03-09T23:59:59+08:00", + "receive_amount": 18, + "save_money": 890, + "index": 1, + "week": [ + { + "index": 1, + "start_time": "2023-02-10T00:00:00+08:00", + "end_time": "2023-02-16T23:59:59+08:00", + "first": 5, + "second": 1, + "third": 1, + "fourth": 1, + "full_reward_state": 1 + }, + { + "index": 2, + "start_time": "2023-02-17T00:00:00+08:00", + "end_time": "2023-02-23T23:59:59+08:00", + "first": 1, + "second": 1, + "third": 1, + "fourth": 1, + "full_reward_state": 1 + }, + { + "index": 3, + "start_time": "2023-02-24T00:00:00+08:00", + "end_time": "2023-03-02T23:59:59+08:00", + "first": 1, + "second": 1, + "third": 1, + "fourth": 1, + "full_reward_state": 1 + }, + { + "index": 4, + "start_time": "2023-03-03T00:00:00+08:00", + "end_time": "2023-03-09T23:59:59+08:00", + "first": 1, + "second": 1, + "third": 1, + "fourth": 1, + "full_reward_state": 1 + } + ], + "month_reward_state": 0, + "month_reward": 0, + "cur_month_end": "2023-03-10T00:00:00+08:00", + "server_time": "2023-02-10T10:59:43+08:00" + } +} +``` + +3：今日已领取,请明日再来
3：还未满足领取条件
4：找不到数据~ | +| msg | str | | | +| data | obj | | | + +**示例：** + +`SESSDATA`方式： + +```shell +curl -L -X POST 'https://manga.bilibili.com/twirp/card.v1.Card/GetLightCoupon' \ +-H 'content-type: application/json; charset=utf-8' \ +-H 'Cookie: SESSDATA=xxx' \ +--data-raw '{"type":1,"weekIndex":1}' +``` + +`access_key`方式： + +```shell +curl -L -X POST 'https://manga.bilibili.com/twirp/card.v1.Card/GetLightCoupon?access_key=xxx' \ +-H 'content-type: application/json; charset=utf-8' \ +--data-raw '{"type":1,"weekIndex":1}' +``` + +
+
\ No newline at end of file
diff --git a/docs/manga/point_shop.md b/docs/manga/point_shop.md
new file mode 100644
index 0000000000..4d121f6047
--- /dev/null
+++ b/docs/manga/point_shop.md
@@ -0,0 +1,451 @@
+# 积分商城
+
+- [获取当前持有点数](#获取当前持有点数)
+- [获取兑换奖品列表](#获取兑换奖品列表)
+- [兑换物品](#兑换物品)
+- [获取兑换历史记录](#获取兑换历史记录)
+- [获取玩法说明](#获取玩法说明)
+
+*积分商城由web页面提供功能，地址为：*
+
+> https://manga.bilibili.com/eden/credits-exchange.html
+
+## 获取当前持有点数
+
+> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetUserPoint
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）/ APP
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | |
+| msg | str | 错误信息 | |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | -------- | ------------ |
+| point | str | 点数 | 不登录时为0 |
+
+**示例：**
+
+```bash
+curl 'https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetUserPoint' \
+-b 'SESSDATA=xxx'
+```
+
+查看响应示例：
+ +```json +{ + "code": 0, + "msg": "", + "data": {} +} +``` + +
+
+
+## 获取兑换奖品列表
+
+> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct
+
+*请求方式：POST*
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | |
+| msg | str | 错误信息 | |
+| data | array | 奖品列表 | |
+
+`data`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------- | ---- |
+| 0 | obj | 奖品1 | |
+| n | obj | 奖品(n+1) | |
+| …… | obj | …… | …… |
+
+`data`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | -------- | ------------ |
+| id | num | 物品id | |
+| type | num | 物品类型 | 0：商城相关查看响应示例：
+ + +```json +{ + "code": 0, + "msg": "", + "data": { + "point": "66666" + } +} +``` + +3：限免券
7：福利券 | +| title | str | 物品名 | | +| image | str | 显示的图像 | 福利券为空 | +| amount | num | 库存总量 | | +| cost | num | 兑换所需点数（原价） | | +| real_cost | num | 兑换所需点数（现价） | | +| remain_amount | num | 库存剩余数 | | +| comic_id | num | 相关漫画id | | +| limits | array | 限定使用范围（漫画） | 限免券所适用的漫画 | +| discount | num | (?) | 目前恒为0 | +| product_type | num | 物品类型 | 1：限免券、福利券
4：商城满99立减10元券、商城5元无门槛券
5：商城5魔晶 | +| pendant_url | str | (?) | | +| pendant_expire | num | (?) | 0：限免券、福利券
7：商城满99立减10元券、商城5元无门槛券、商城5魔晶 | +| exchange_limit | num | 兑换次数限制 | | +| address_deadline | str | (?) | | +| act_type | num | (?) | 目前恒为0 | +| has_exchanged | bool | 是否兑换过该物品 | | +| main_coupon_deadline | str | 兑换后使用截止时间 | | +| deadline | str | 兑换后使用截止时间 | | +| point | str | (?) | 目前恒为0 | + +**示例：** + +```bash +curl 'https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/ListProduct' +``` + +
+
+
+
+## 兑换物品
+
+> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/Exchange
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）/ APP
+
+**正文参数（ application/x-www-form-urlencoded 或 application/json）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
+| product_id | str | 物品id | 必要 | |
+| product_num | num | 兑换个数 | 必要 | |
+| point | num | 物品所需点数 | 必要 | 现价（real_cost） |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：兑换成功查看响应示例：
+ + +```json +{ + "code": 0, + "msg": "", + "data": [ + { + "id": 195, + "type": 7, + "title": "积分兑换", + "image": "", + "amount": 15999, + "cost": 200, + "real_cost": 100, + "remain_amount": 0, + "comic_id": 0, + "limits": [], + "discount": 0, + "product_type": 1, + "pendant_url": "", + "pendant_expire": 7, + "exchange_limit": 0, + "address_deadline": "0001-01-01T00:00:00Z", + "act_type": 0, + "has_exchanged": false, + "main_coupon_deadline": "0001-01-01T00:00:00Z", + "deadline": "", + "point": "0" + }, + { + "id": 1009, + "type": 0, + "title": "商城5魔晶", + "image": "", + "amount": 500, + "cost": 260, + "real_cost": 30, + "remain_amount": 0, + "comic_id": 0, + "limits": [], + "discount": 0, + "product_type": 5, + "pendant_url": "", + "pendant_expire": 0, + "exchange_limit": 1, + "address_deadline": "0001-01-01T00:00:00Z", + "act_type": 0, + "has_exchanged": false, + "main_coupon_deadline": "2022-03-22T23:59:59+08:00", + "deadline": "2022-03-22T23:59:59+08:00", + "point": "0" + }, + { + "id": 1008, + "type": 0, + "title": "商城满99立减10元券", + "image": "", + "amount": 400, + "cost": 2000, + "real_cost": 400, + "remain_amount": 390, + "comic_id": 0, + "limits": [], + "discount": 0, + "product_type": 4, + "pendant_url": "", + "pendant_expire": 0, + "exchange_limit": 1, + "address_deadline": "0001-01-01T00:00:00Z", + "act_type": 0, + "has_exchanged": false, + "main_coupon_deadline": "2022-03-22T23:59:59+08:00", + "deadline": "2022-03-22T23:59:59+08:00", + "point": "0" + }, + { + "id": 1007, + "type": 0, + "title": "商城5元无门槛券", + "image": "", + "amount": 200, + "cost": 1000, + "real_cost": 200, + "remain_amount": 134, + "comic_id": 0, + "limits": [], + "discount": 0, + "product_type": 4, + "pendant_url": "", + "pendant_expire": 0, + "exchange_limit": 1, + "address_deadline": "0001-01-01T00:00:00Z", + "act_type": 0, + "has_exchanged": false, + "main_coupon_deadline": "2022-03-22T23:59:59+08:00", + "deadline": "2022-03-22T23:59:59+08:00", + "point": "0" + }, + { + "id": 1536, + "type": 3, + "title": "白兔糖", + "image": "http://i0.hdslb.com/bfs/manga-static/c3369754789a77b5d0b15cc31c75538ac035b3aa.jpg", + "amount": 4000, + "cost": 100, + "real_cost": 75, + "remain_amount": 3991, + "comic_id": 27164, + "limits": [ + { + "type": 1, + "id": 27164, + "title": "白兔糖" + } + ], + "discount": 0, + "product_type": 1, + "pendant_url": "", + "pendant_expire": 7, + "exchange_limit": 0, + "address_deadline": "0001-01-01T00:00:00Z", + "act_type": 0, + "has_exchanged": false, + "main_coupon_deadline": "0001-01-01T00:00:00Z", + "deadline": "", + "point": "0" + } + ] +} +``` + +1：积分不足
1：您点的太快了~
2：库存不足
3：product point mismatch（point填写错误）
3：超过用户最大可兑换数量
4：现在抢票的人太多啦，再点一下有机会优先上车喔 ε=ε=(ノ≧∇≦)ノ | +| message | str | 错误信息 | | + +**示例：** + +```bash +curl 'https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/Exchange' \ +--data-urlencode 'product_id=195' \ +--data-urlencode 'product_num=1' \ +--data-urlencode 'point=real_cost' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 获取兑换历史记录
+
+> https://manga.bilibili.com/twirp/activity.v1.Activity/GetPrizeList
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）/ APP
+
+**正文参数（ application/x-www-form-urlencoded 或 application/json）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
+| act_id | num | 固定值：90018 | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | |
+| msg | str | 错误信息 | | |
+| data | obj | 信息本体 |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------ | ---- | -------- | ---- |
+| prizes | obj | 兑换记录 | |
+| addr | obj | (?) | |
+
+`data`中的`prizes`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | -------- | ------------ |
+| user_prize_id | str | 兑换id? | |
+| prize_id | num | 兑换的物品id | |
+| ctime | str | 兑换时间 | |
+| addr | null | (?) | |
+| deadline | str | 过期时间 | |
+| type | num | 类型 | 1：限免券、福利券查看响应示例：
+ +```json +{ + "code": 0, + "msg": "" +} +``` + +8：商城5魔晶 | +| name | str | 物品名 | | + +**示例：** + +```bash +curl 'https://manga.bilibili.com/twirp/activity.v1.Activity/GetPrizeList' \ +--data-urlencode 'act_id=90018' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 获取玩法说明
+
+> https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule
+
+*请求方式：POST*
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | -------- | ---- |
+| code | num | 返回值 | |
+| msg | str | 错误信息 | |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | -------- | ---- |
+| rule | str | 玩法说明 | |
+
+**示例：**
+
+```bash
+curl 'https://manga.bilibili.com/twirp/pointshop.v1.Pointshop/GetExchangeRule'
+```
+
+查看响应示例：
+ +```json +{ + "code": 0, + "msg": "", + "data": { + "prizes": [ + { + "user_prize_id": "55117444", + "prize_id": 1009, + "ctime": "2022-03-21T12:22:53+08:00", + "addr": null, + "deadline": "0001-01-01T00:00:00Z", + "type": 8, + "name": "商城5魔晶" + }, + { + "user_prize_id": "2594073385420523088", + "prize_id": 1536, + "ctime": "2022-03-21T12:07:24+08:00", + "addr": null, + "deadline": "0001-01-01T00:00:00Z", + "type": 1, + "name": "白兔糖限免卡" + }, + { + "user_prize_id": "4899916394614914913", + "prize_id": 195, + "ctime": "2021-12-24T12:01:08+08:00", + "addr": null, + "deadline": "0001-01-01T00:00:00Z", + "type": 1, + "name": "积分兑换" + }, + { + "user_prize_id": "1152921504636496551", + "prize_id": 195, + "ctime": "2021-12-13T12:05:13+08:00", + "addr": null, + "deadline": "0001-01-01T00:00:00Z", + "type": 1, + "name": "积分兑换" + } + ], + "addr": { + "name": "", + "phone": "", + "address": "", + "id_card": "" + } + } +} +``` + +
+
diff --git a/docs/message/msg.md b/docs/message/msg.md
new file mode 100644
index 0000000000..4753391ed6
--- /dev/null
+++ b/docs/message/msg.md
@@ -0,0 +1,65 @@
+# 通知消息
+
+- [未读消息数](#未读消息数)
+
+---
+
+## 未读消息数
+
+> https://api.bilibili.com/x/msgfeed/unread
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ----------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ + +```json +{ + "code": 0, + "msg": "", + "data": { + "rule": "日常兑换说明：\n1、赛季积分达到一定数量可兑换积分商城内相应的商品；\n2、日常兑换奖品的刷新时间为每日中午12点，每天可兑换的奖品总数有限（具体可见商品页面展示），请尽快兑换。\n3、兑换的福利券＆限免卡奖品有效期详见兑换框内显示或卡券包内详情说明哦，请及时在有效期内使用。\n4、赛季积分有效期为当前赛季时长（每期赛季时长详见福利中心页面倒计时显示），请及时在有效期内进行使用。\n5、赛季积分可在福利中心完成特定任务获取，具体详情可至福利中心查看（部分活动也可获取赛季积分，可随时关注活动信息哦）。" + } +} +``` + +-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------------- | ------------ | +| at | num | 未读at数 | | +| chat | num | 0 | 作用尚不明确 | +| like | num | 未读点赞数 | | +| reply | num | 未读回复数 | | +| sys_msg | num | 未读系统通知数 | | +| up | num | UP主助手信息数 | | + +**示例：** + +以下信息代表了未读点赞数为10，未读回复数为4，未读at消息数为3，未读系统通知数为2，UP主助手信息数为1 + +```shell +curl 'https://api.bilibili.com/x/msgfeed/unread' \ +-b 'SESSDATA=xxx' +``` + +
+
diff --git a/docs/message/private_msg.md b/docs/message/private_msg.md
new file mode 100644
index 0000000000..598e17f6ee
--- /dev/null
+++ b/docs/message/private_msg.md
@@ -0,0 +1,374 @@
+# 私信
+
+- [未读私信数](#未读私信数)
+- [发送私信（web端）](#发送私信web端)
+- [私信消息记录](#私信消息记录)
+---
+
+## 未读私信数
+
+> https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "at": 3, + "chat": 0, + "like": 10, + "reply": 4, + "sys_msg": 2, + "up": 1 + } +} +``` + +-6：账号未登录 | +| message | str | 错误信息 | 默认为ok | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data` 对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | -------------------- | ---- | +| unfollow_unread | num | 未关注用户未读私信数 | | +| follow_unread | num | 已关注用户未读私信数 | | +| _gt_ | num | 0 | | + +**示例：** + +以下信息代表了为未关注用户未读私信数为`1`条，已关注用户未读私信数为`6`条 + +```shell +curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 发送私信（web端）
+
+> https://api.vc.bilibili.com/web_im/v1/web_im/send_msg
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（application/x-www-form-urlencoded）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------------------ | ------------------------------------ | ------------------------ | ------ | -------------------------------------- |
+| msg[sender_uid] | num | 发送者mid | 必要 | |
+| msg[receiver_id] | num | 接收者mid | 必要 | |
+| msg[receiver_type] | num | 1 | 必要 | 固定为1 |
+| msg[msg_type] | num | 消息类型 | 必要 | 1:发送文字查看响应示例：
+ +```json +{ + "code": 0, + "msg": "ok", + "message": "ok", + "data": { + "unfollow_unread": 1, + "follow_unread": 6, + "_gt_": 0 + } +} +``` + +2:发送图片
5:撤回消息 | +| msg[msg_status] | num | 0 | 非必要 | | +| msg[dev_id] | string | 372778FD-E359-461D-86A3-EA2BCC6FF52A | 必要 | **获取方式在下面** | +| msg[timestamp] | num | 时间戳（秒） | 必要 | | +| msg[content] | 发送文字时：str
撤回消息时：num | 消息内容 | 必要 | **详见下表** | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +--- + +**dev_id的获取** + +以JS为例： + +```javascript +const deviceid = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (function (name) { + let randomInt = 16 * Math.random() | 0; + return ("x" === name ? randomInt : 3 & randomInt | 8).toString(16).toUpperCase() +})); +``` + +代码来自 [andywang425/BLTH](https://github.com/andywang425/BLTH/blob/45fe93e31754ca8bf07059d46266398e787dbf45/B%E7%AB%99%E7%9B%B4%E6%92%AD%E9%97%B4%E6%8C%82%E6%9C%BA%E5%8A%A9%E6%89%8B.js#L6618) + +以Java为例 + +```java +public class Util{ + private String getDevId() { + char[] b = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'}; + char[] s = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".toCharArray(); + for (int i = 0; i < s.length; i++) { + if ('-' == s[i] || '4' == s[i]) { + continue; + } + int randomInt = (int) (16 * Math.random()); + if ('x' == s[i]) { + s[i] = b[randomInt]; + } else { + s[i] = b[3 & randomInt | 8]; + } + } + return new String(s); + } +} +``` +--- + +`msg[content]`消息内容： + +当发送文字时（`msg[msg_type]=1`）： + +该参数为json序列字串 + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ---- | +| content | str | 私信内容 | | + +当发送图片时（`msg[msg_type]=2`）： + +该参数为json序列字串 + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | -------- | :-------------------------------------------- | +| url | str | 图片url | 默认为B站相簿图片上传通道
也可用三方图床 | +| width | num | 图片的宽 | 单位：像素（非必要） | +| height | num | 图片的高 | 单位：像素（非必要） | +| type | str | 图片格式 | （非必要） | +| original | num | 1 | **作用未知**（非必要） | +| size | num | 文件大小 | 单位：千字节（非必要）
__向上取整__ | + +当撤回消息时（`msg[msg_type]=5`）： + +该参数为数值，为目标消息的` msg_key ` + +**json回复：** + +根对象： +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------- | +| code | num | 返回值 | 0：成功
| +| message | str | 错误信息 | 默认为ok | +| ttl | num | | 默认为1 | +| data | obj | 主体 | 出错时为空 | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ---------- | ------------ | +| msg_key| num | 消息唯一id | | +| msg_content | str | 发送的消息 | | +| key_hit_infos | obj | | 作用尚不明确 | + +**示例：** + +给目标用户`mid=1`发一条文字私信： + +> up主你好， +> +> 催更[doge] + +```shell +curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \ +--data-urlencode 'msg[sender_uid]=293793435' \ +--data-urlencode 'msg[receiver_id]=1' \ +--data-urlencode 'msg[receiver_type] =1' \ +--data-urlencode 'msg[msg_type]=1' \ +--data-urlencode 'msg[dev_id] =372778FD-E359-461D-86A3-EA2BCC6FF52A' \ +--data-urlencode 'msg[timestamp] =1626181379' \ +--data-urlencode 'msg[content]={"content":"up主你好，\n催更[doge]"}' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+给目标用户`mid=1`发一条图片私信：
+
+> 查看响应示例：
+ +```json +{"code":0, +"message":"0", +"ttl":1, +"data":{"msg_key":6984393491767669026, + "msg_content":"up主你好，\n催更[doge]", + "key_hit_infos":{}}} +``` + +
+
+```shell
+curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
+--data-urlencode 'msg[sender_uid]=293793435' \
+--data-urlencode 'msg[receiver_id]=1' \
+--data-urlencode 'msg[receiver_type] =1' \
+--data-urlencode 'msg[msg_type]=2' \
+--data-urlencode 'msg[content]={"url":https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg}' \
+--data-urlencode 'csrf_token=xxx' \
+-b 'SESSDATA=xxx'
+```
+
+
+
+
+## 私信消息记录
+
+> https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs
+
+*请求方式：GET*
+
+此接口有设计缺陷，能够获取已经撤回，无法显示（如 发送私信 中msg[msg_type]:3）的消息
+
+认证方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------------ | ------------------ |
+| sender_device_id | num | 发送者设备 | 可选 | 1 |
+| talker_id | num | 聊天对象的UID | 必要 | -------------- |
+| session_type | num | 聊天对象的类型 | 必要 | 1为用户，2为粉丝团 |
+| size | num | 列出消息条数 | 可选 | 默认是20 |
+| build | num | 未知 | 可选 | 默认是0 |
+| mobi_app | str | 设备 | 可选 | web |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ------ | -------- | ---------------------------- |
+| code | num | 返回值 | 0：成功 查看响应示例：
+ +```json +{ + "code":0, + "msg":"ok", + "message":"ok", + "data":{ + "msg_key":6852570013146024354, + "_gt_":0 + } +} +``` + +-400：请求错误 | +| msg | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 数据列表 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---- | +| messages | array | 聊天记录列表 | | +| has_more | num | 0 | | +| min_seqno | num | 未知 | | +| max_seqno | num | 未知 | | +| e_infos | array | 聊天表情列表 | | + +`messages`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---- | +| sender_uid | num | 发送者uid | 注意名称是sender_uid | +| receiver_type | num | 与session_type对应 | 1为用户，2为粉丝团 | +| receiver_id | num | 接收者uid | 注意名称是receiver_id | +| msg_type | num | 消息类型 | 1:文字消息
2:图片消息
5:撤回的消息
12、13:通知 | +| content | str | 消息内容 | 此处存在设计缺陷 | +| msg_seqno | num | 未知 | | +| timestamp | num | 消息发送时间戳 | | +| at_uids | array | 未知 | | +| msg_key | num | 未知 | | +| msg_status | num | 消息状态 | 0 | +| notify_code |str | 未知 | | +| new_face_version |num | 未知 | 疑似只在粉丝团消息中出现 | + +`e_infos`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---- | +| text | str | 表情名称 | | +| uri | str | 表情链接 | | +| size | num | 表情尺寸 | 1 | + +**示例：** + +获取与目标用户`mid=123`私信记录： + +```shell +curl 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs?sender_device_id=1&talker_id=123&session_type=1&size=20&build=0&mobi_app=web' \ +-b 'SESSDATA=xxx' +``` + +
+
+
diff --git a/docs/newbie_exam/action.md b/docs/newbie_exam/action.md
new file mode 100644
index 0000000000..738a6a4170
--- /dev/null
+++ b/docs/newbie_exam/action.md
@@ -0,0 +1,456 @@
+# 操作
+
+- [提交答题](#提交答题)
+ - [提交基础题](#提交基础题)
+ - [提交附加题](#提交附加题)
+ - [提交自选题](#提交自选题)
+- [获取验证码](#获取验证码)
+- [提交验证码](#提交验证码)
+- [提交自选题分类](#提交自选题分类)
+- [提前交卷](#提前交卷)
+
+---
+
+## 提交答题
+
+### 提交基础题
+
+> https://api.bilibili.com/x/answer/v4/base/check
+
+*请求方式：POST*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------------------ | -------------- | ------------------------------------------ |
+| question_id | num | 题目id | 必要 | 从[拉取基础题api](fetch.md#拉取基础题)获得 |
+| ans_hash | str | 选项hash | 必要 | 从[拉取基础题api](fetch.md#拉取基础题)获得 |
+| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "msg": "0", + "message": "0", + "ttl": 1, + "data": { + "messages": [ + { + "sender_uid": 2239814, + "receiver_type": 1, + "receiver_id": 123, + "msg_type": 1, + "content": "{\"content\":\"[口罩]\"}", + "msg_seqno": 309675413389322, + "timestamp": 1654154093, + "at_uids": [ + 0 + ], + "msg_key": 7104537732714964358, + "msg_status": 0, + "notify_code": "", + "new_face_version": 1 + }, + { + "sender_uid": 2239814, + "receiver_type": 1, + "receiver_id": 123, + "msg_type": 5, + "content": "{\"content\":\"1\"}", + "msg_seqno": 308302399586307, + "timestamp": 1654072255, + "at_uids": [ + 0 + ], + "msg_key": 7104186240789226795, + "msg_status": 0, + "notify_code": "" + }, + ], + "has_more": 0, + "min_seqno": 308188515844097, + "max_seqno": 309675413389322, + "e_infos": [ + { + "text": "[口罩]", + "url": "http://i0.hdslb.com/bfs/emote/3ad2f66b151496d2a5fb0a8ea75f32265d778dd3.png", + "size": 1 + } + ] + } +} +``` + +-101：账号未登录
-400：请求错误
41014：答题过快或错误太多
41012：用户答题提交题目id不合法
41020：用户基础题已通过
41023：用户答题记录不存在 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ------------ | ----------------------------------- | +| passed | bool | 选项是否正确 | true：选项正确
false：选项错误 | + +**示例：** + +提交题目id为`104`的题，选项hash为`cb4c8cc9424fc771f7c1598e74de498f` + +```shell +curl 'https://api.bilibili.com/x/answer/v4/base/check' \ +--data-urlencode 'question_id=104' \ +--data-urlencode 'ans_hash=cb4c8cc9424fc771f7c1598e74de498f' \ +--data-urlencode 'csrf=xxxx' \ +-b 'SESSDATA=xxxx' +``` + +
+
+
+### 提交附加题
+
+> https://api.bilibili.com/x/answer/v4/base/check
+
+*请求方式：POST*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------------------ | -------------- | ------------------------------------------ |
+| question_id | num | 题目id | 必要 | 从[拉取基础题api](fetch.md#拉取基础题)获得 |
+| ans_hash | str | 选项hash | 必要 | 从[拉取基础题api](fetch.md#拉取基础题)获得 |
+| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "passed": true + } +} +``` + +-101：账号未登录
-400：请求错误
41014：答题过快或错误太多
41012：用户答题提交题目id不合法
41023：用户答题记录不存在 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ------------ | ----------------------------------- | +| passed | bool | 选项是否正确 | true：选项正确
false：选项错误 | + +**示例：** + +提交题目id为`104`的题，选项hash为`cb4c8cc9424fc771f7c1598e74de498f` + +```shell +curl 'https://api.bilibili.com/x/answer/v4/base/check' \ +--data-urlencode 'question_id=104' \ +--data-urlencode 'ans_hash=cb4c8cc9424fc771f7c1598e74de498f' \ +--data-urlencode 'csrf=xxxx' \ +-b 'SESSDATA=xxxx' +``` + +
+
+
+### 提交自选题
+
+> https://api.bilibili.com/x/answer/v4/pro/check
+
+*请求方式：POST*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------------------ | -------------- | ------------------------------------------ |
+| question_id | num | 题目id | 必要 | 从[拉取基础题api](fetch.md#拉取基础题)获得 |
+| ans_hash | str | 选项hash | 必要 | 从[拉取基础题api](fetch.md#拉取基础题)获得 |
+| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "passed": true + } +} +``` + +-101：账号未登录
-400：请求错误
41014：答题过快或错误太多
41012：用户答题提交题目id不合法
41023：用户答题记录不存在
41026：获取用户DB题目信息异常 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ---- | ---------- | +| passed | bool | true | 恒为`true` | + +**示例：** + +提交题目id为`2935`的题，选项hash为`ffd55cbe0624f466bee2ea3eb576a4d0` + +```shell +curl -G 'https://api.bilibili.com/x/answer/v4/pro/check' \ +--data-urlencode 'question_id=2935' \ +--data-urlencode 'ans_hash=ffd55cbe0624f466bee2ea3eb576a4d0' \ +--data-urlencode 'csrf=xxxx' \ +-b 'SESSDATA=xxxx' +``` + +
+
+
+## 获取验证码
+
+> https://api.bilibili.com/x/answer/v4/captcha
+
+*请求方式：GET*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "passed": true + } +} +``` + +-101：账号未登录
-400：请求错误
41010：用户答题非法访问
41014：答题过快或错误太多
41020：用户基础题已通过
41021：用户基础题未通过 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | ----------- | ------------- | +| type | str | 验证码类型? | geetest：极验 | +| gt | str | 极验id | | +| challenge | str | 极验key | | +| token | str | (?) | | +| url | str | (?) | | + +**示例：** + +```shell +curl 'https://api.bilibili.com/x/answer/v4/captcha' \ +-b 'SESSDATA=xxxx' +``` + +
+
+
+## 提交验证码
+
+> https://api.bilibili.com/x/answer/v4/captcha/check
+
+*请求方式：POST*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**注：**
+
+旧版`edition=0`同时提交自选题分类以及验证码
+
+新版`edition=2`仅仅提交验证码
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------------- | ---- | ---------------------- | -------------- | ---------------- |
+| types | nums | 自选题分类(旧版) | 非必要 | 新版不需要此字段 |
+| type | str | 验证码类型 | 非必要 | |
+| bilibili_token | str | | 非必要 | |
+| bilibili_code | str | | 非必要 | |
+| geetest_challenge | str | 极验key | 非必要 | |
+| geetest_seccode | str | 极验结果+\|jordan | 非必要 | |
+| geetest_validate | str | 极验结果 | 非必要 | |
+| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "type": "geetest", + "gt": "abc55d1fb914cb110cfb4c232a4b4c35", + "challenge": "90a6e03e626e13ee186ddae0107c3ae2", + "token": "", + "url": "" + } +} +``` + +-101：账号未登录
-105：验证码错误
-400：请求错误
41010：用户答题非法访问
41014：答题过快或错误太多
41021：用户基础题未通过
41031：自选题未通过 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +```shell +curl 'https://api.bilibili.com/x/answer/v4/captcha/check' \ +--data-urlencode 'types=' \ +--data-urlencode 'type=geetest' \ +--data-urlencode 'bilibili_token=' \ +--data-urlencode 'bilibili_code=' \ +--data-urlencode 'geetest_challenge=3f809a7a9c51edca751fd26c032c182d' \ +--data-urlencode 'geetest_seccode=513ec576a275a3eb250829202d4dce46|jordan' \ +--data-urlencode 'geetest_validate=513ec576a275a3eb250829202d4dce46' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxxx' +``` + +
+
+
+## 提交自选题分类
+
+> https://api.bilibili.com/x/answer/v4/pro/type/check
+
+*请求方式：POST*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ---------------------- | -------------- | ---- |
+| types | nums | 自选题分类(新版) | 必要 | |
+| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-101：账号未登录
-400：请求错误
41010：用户答题非法访问
41014：答题过快或错误太多
41021：用户基础题未通过
41031：自选题未通过
41052：用户题目类型不合法
41055：基础附加题未通过 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +选择`游戏` `影视` `科教/知识` `动画/动漫`分类 + +```shell +curl 'https://api.bilibili.com/x/answer/v4/pro/type/check' \ +--data-urlencode 'types=1,2,3,4' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxxx' +``` + +
+
+
+## 提前交卷
+
+> https://api.bilibili.com/x/answer/v4/submit
+
+*请求方式：POST*
+
+认证方式：APP或Cookie（SESSDATA）
+
+当当前得分>=60时，可请求本接口提前完成答题
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ---------------------- | -------------- | ---- |
+| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-101：账号未登录
-400：请求错误
41014：答题过快或错误太多
41023：用户答题记录不存在
41031：自选题未通过 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ---- | ---------------- | -------------------------------------------- | +| hid | num | 答题会话id | | +| mid | num | 答题用户mid | | +| score | num | 得分 | | +| status | num | 0 | | +| number | num | 0 | | +| result | str | succeed | | +| stage | str | result | | +| version | str | 版本 | 目前为`v4` | +| start_time | num | 本次答题开始时间 | 时间戳 | +| first_answer | num | 0 | | +| progress | str | | | +| text | str | | | +| url | str | | | +| in_reg_audit | bool | | | +| edition | num | 答题版本 | 0：旧版（40+10+50）
2：新版（40+30+30） | +| rewards | null | | | +| captcha | num | 1 | | + +**示例：** + +```shell +curl 'https://api.bilibili.com/x/answer/v4/submit' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxxx' +``` + +
+
diff --git a/docs/newbie_exam/fetch.md b/docs/newbie_exam/fetch.md
new file mode 100644
index 0000000000..5b52e272c5
--- /dev/null
+++ b/docs/newbie_exam/fetch.md
@@ -0,0 +1,263 @@
+# 拉取题目
+
+- [拉取基础题](#拉取基础题)
+- [拉取附加题](#拉取附加题)
+- [拉取自选题](#拉取自选题)
+
+---
+
+## 拉取基础题
+
+> https://api.bilibili.com/x/answer/v4/base
+
+*请求方式：GET*
+
+认证方式：Cookie或APP
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "hid": 1623207905520705, + "mid": 293793435, + "score": 63, + "status": 3, + "number": 0, + "result": "succeed", + "stage": "result", + "version": "v4", + "start_time": 1636889218, + "first_answer": 0, + "progress": "", + "text": "", + "url": "", + "in_reg_audit": false, + "edition": 0, + "rewards": null, + "captcha": 1 + } +} +``` + +-101：账号未登录
41014：答题过快或错误太多
41020：用户基础题已通过
41023：用户答题记录不存在 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | -------- | ---- | +| question | obj | 题目内容 | | + +`data`中的`question`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | ------------------ | ------------------------------------------------------------ | +| id | num | 问题id | **问题id不代表题图，因为选项是打乱的** | +| number | num | 当前题号 | | +| q_height | num | 问题部分总高度 | | +| q_coord_y | num | 问题部分Y裁剪起始 | 当然是0 | +| image | str | 题图url | 题目文字+所有的选项文字排版成一张图，存储在bfs中 | +| from | str | 问题来源页面url | 如：“xx弹幕是否违规”所在的视频页 | +| options | array | 选项列表 | | +| type_id | num | 题目父类型id | 见[查询自选题分类](info.md#查询自选题分类)
**注：36为基础题** | +| type_name | str | 分院小电视提示文案 | 如：xx小电视 | +| type_image | str | 分院小电视图标url | | + +`question`中的`options`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----- | ---------------------- | +| 0 | obj | 选项A | | +| 1 | obj | 选项B | 选项至少2个 | +| 2 | obj | 选项C | 数组长度取决于选项个数 | +| 3 | obj | 选项D | | + +`question`中的`options`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | ----------------- | ------------------------ | +| number | num | 选项序号 | 如：1为A 2为B | +| high | num | 选项部分总高度 | | +| coord_y | num | 选项部分Y裁剪起始 | | +| hash | str | 选项hash | 作为提交对应选项时应传参 | + +**示例：** + +```shell +curl -G 'https://api.bilibili.com/x/answer/v4/base' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 拉取附加题
+
+> https://api.bilibili.com/x/answer/v4/extra
+
+*请求方式：GET*
+
+认证方式：Cookie或APP
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "question": { + "id": 6511, + "number": 1, + "q_height": 38.4, + "q_coord_y": 0, + "image": "https://i0.hdslb.com/bfs/member/9d7f1f1f0b7478a621d1b998a5a98982.png", + "from": "", + "options": [ + { + "number": 1, + "high": 42, + "coord_y": 38.4, + "hash": "f7619d6c2040d44f39dc87a7aa34fb9e" + }, + { + "number": 2, + "high": 42, + "coord_y": 80.4, + "hash": "dce5140040f40ca4030783585684369d" + } + ], + "type_id": 36, + "type_name": "小电视校长", + "type_image": "https://i0.hdslb.com/bfs/face/7b67c0c0da64a6ab059ff49bb0d4b92988b91806.png" + } + } +} +``` +-101：账号未登录
41014：答题过快或错误太多
41021：用户基础题未通过
41023：用户答题记录不存在
41054：用户附加题已通过 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +同[拉取基础题](#拉取基础题)的`data`对象 + +**示例：** + +```shell +curl -G 'https://api.bilibili.com/x/answer/v4/extra' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 拉取自选题
+
+> https://api.bilibili.com/x/answer/v4/pro
+
+*请求方式：GET*
+
+认证方式：Cookie或APP
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "question": { + "id": 11492, + "number": 44, + "q_height": 76.8, + "q_coord_y": 0, + "image": "https://i0.hdslb.com/bfs/member/b6c846613bd0b44cd7c8af1d83e3f0c2.png", + "from": "https://www.bilibili.com/video/av14659093", + "options": [ + { + "number": 1, + "high": 42, + "coord_y": 76.8, + "hash": "ca15e6009047cf82358c50ab90fd8d9e" + }, + { + "number": 2, + "high": 42, + "coord_y": 118.8, + "hash": "60e86a1c736c68da3462f66377e4e8ca" + } + ], + "type_id": 36, + "type_name": "小电视校长", + "type_image": "https://i0.hdslb.com/bfs/face/7b67c0c0da64a6ab059ff49bb0d4b92988b91806.png" + } + } +} +``` +-101：账号未登录
41014：答题过快或错误太多
41021：用户基础题未通过
41023：用户答题记录不存在
41051：用户答题验证码未通过
41055：基础附加题未通过 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +同[拉取基础题](#拉取基础题)的`data`对象 + +**示例：** + +```shell +curl -G 'https://api.bilibili.com/x/answer/v4/pro' \ +-b 'SESSDATA=xxx' +``` + +
+
+
diff --git a/docs/newbie_exam/info.md b/docs/newbie_exam/info.md
new file mode 100644
index 0000000000..135d6c3c6f
--- /dev/null
+++ b/docs/newbie_exam/info.md
@@ -0,0 +1,556 @@
+# 查询信息
+
+- [查询答题状态](#查询答题状态)
+- [查询自选题分类](#查询自选题分类)
+- [查询答题结果](#查询答题结果)
+
+---
+
+## 查询答题状态
+
+> https://api.bilibili.com/x/answer/v4/status
+
+*请求方式：GET*
+
+认证方式：Cookie或APP
+
+**json回复：**
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "question": { + "id": 824, + "number": 54, + "q_height": 38.4, + "q_coord_y": 0, + "image": "https://i0.hdslb.com/bfs/member/417e02be5652f79d0312fa2fcee28869.png", + "from": "", + "options": [ + { + "number": 1, + "high": 42, + "coord_y": 38.4, + "hash": "c4574c23cf728c19abeab3e7525258d4" + }, + { + "number": 2, + "high": 42, + "coord_y": 80.4, + "hash": "ffd48760758fbb8a2c183d1d04f692f8" + }, + { + "number": 3, + "high": 42, + "coord_y": 122.4, + "hash": "898d414dff49fe20c4a1da1e148fadb2" + }, + { + "number": 4, + "high": 42, + "coord_y": 164.4, + "hash": "09018443f09d8ef4f6fec5e96e082270" + } + ], + "type_id": 1, + "type_name": "游戏小电视", + "type_image": "https://i0.hdslb.com/bfs/face/6590bee26086fed66ee7cc5bac26a32d2f733037.png" + } + } +} +``` + +-101：账号未登录
41014：答题过快或错误太多 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ---- | ------------------ | ------------------------------------------------------------ | +| hid | num | 答题会话id | | +| mid | num | 答题用户mid | | +| score | num | 当前得分 | | +| status | num | 答题状态 | 0：未答题
2：答题中
3：已通过 | +| number | num | 当前题号 | | +| result | str | 是否通过答题 | failed：未通过
succeed：已通过 | +| stage | str | 当前答题阶段 | base：基础题
extra：附加题
pro_type：等待选择自选题类型
pro：自选题
complete：已完成 | +| version | str | 答题版本 | 当前为`v4` | +| start_time | num | 本次答题开始时间 | 时间戳 | +| first_answer | num | （?） | | +| progress | str | 当前答题进度 | 百分比
60分为100% | +| text | str | 提示文案 | | +| url | str | 答题页面url | | +| in_reg_audit | bool | 是否为第一次答题 | | +| edition | num | 答题版本 | 0：旧版（40+10+50）
2：新版（40+30+30） | +| rewards | null | (?) | | +| captcha | num | 是否已经提交验证码 | 1：已提交
仅新版提交验证码后存在 | + +**示例：** + +```shell +curl -G 'https://api.bilibili.com/x/answer/v4/status' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询自选题分类
+
+> https://api.bilibili.com/x/answer/v4/pro/type
+
+*请求方式：GET*
+
+认证方式：Cookie或APP
+
+当字段`edition`的值不同时，该接口返回的数据也不同
+
+**json回复：**
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----- | ---------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "hid": 1623207905520705, + "mid": 293793435, + "score": 2, + "status": 2, + "number": 2, + "result": "failed", + "stage": "base", + "version": "v4", + "start_time": 1623207905, + "first_answer": 2, + "progress": "3", + "text": "继续答题", + "url": "https://www.bilibili.com/h5/newbie/entry?navhide=1", + "in_reg_audit": false, + "edition": 0, + "rewards": null + } +} +``` + +-101：账号未登录
41014：答题过快或错误太多
41021：用户基础题未通过
41031：自选题未通过
41055：基础附加题未通过 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 父分类列表 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | ---- | +| 0 | obj | 父分类1 | | +| n | obj | 父分类(n+1) | | +| …… | obj | …… | …… | + +`data`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ----- | ---------- | ---- | +| id | num | 父分类id | | +| name | str | 父分类名 | | +| fields | array | 子分类列表 | | + +`data`数组中的对象中的`fields`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | ---- | +| 0 | obj | 子分类1 | | +| n | obj | 子分类(n+1) | | +| …… | obj | …… | …… | + +`fields`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ---- | +| id | num | 子分类id | | +| name | str | 子分类名 | | + +**示例：** + +```shell +curl -G 'https://api.bilibili.com/x/answer/v4/pro/type' \ +-b 'SESSDATA=xxx' +``` + +旧版`edition=0`返回： + +
+
+
+新版`edition=2`返回：
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + { + "id": 1, + "name": "游戏", + "fields": [ + { + "id": 8, + "name": "动作射击" + }, + { + "id": 9, + "name": "冒险格斗" + }, + { + "id": 12, + "name": "策略模拟 " + }, + { + "id": 13, + "name": "角色扮演 " + }, + { + "id": 14, + "name": "音乐体育 " + } + ] + }, + { + "id": 2, + "name": "影视", + "fields": [ + { + "id": 15, + "name": "纪录片 " + }, + { + "id": 16, + "name": "电影 " + }, + { + "id": 17, + "name": "电视剧 " + } + ] + }, + { + "id": 3, + "name": "科技", + "fields": [ + { + "id": 18, + "name": "军事 " + }, + { + "id": 19, + "name": "地理 " + }, + { + "id": 20, + "name": "历史 " + }, + { + "id": 21, + "name": "文学 " + }, + { + "id": 22, + "name": "数学 " + }, + { + "id": 23, + "name": "物理 " + }, + { + "id": 24, + "name": "化学 " + }, + { + "id": 25, + "name": "生物 " + }, + { + "id": 26, + "name": "数码科技 " + } + ] + }, + { + "id": 4, + "name": "动画", + "fields": [ + { + "id": 27, + "name": "动画声优 " + }, + { + "id": 28, + "name": "动漫内容 " + } + ] + }, + { + "id": 5, + "name": "艺术", + "fields": [ + { + "id": 29, + "name": "ACG音乐 " + }, + { + "id": 30, + "name": "三次元音乐 " + }, + { + "id": 31, + "name": "绘画 " + } + ] + }, + { + "id": 6, + "name": "流行前线", + "fields": [ + { + "id": 32, + "name": "娱乐 " + }, + { + "id": 33, + "name": "时尚 " + }, + { + "id": 34, + "name": "运动 " + } + ] + }, + { + "id": 7, + "name": "鬼畜", + "fields": [ + { + "id": 35, + "name": "鬼畜 " + } + ] + } + ] +} +``` + +
+
+
+
+## 查询答题结果
+
+> https://api.bilibili.com/x/answer/v4/result
+
+*请求方式：GET*
+
+认证方式：无
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ---------- | ------ | ---- |
+| hid | num | 答题会话id | 必要 | |
+
+**json回复：**
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ---------------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + { + "id": 1, + "name": "游戏", + "fields": [ + { + "id": 1, + "name": "游戏" + } + ] + }, + { + "id": 2, + "name": "影视", + "fields": [ + { + "id": 2, + "name": "影视" + } + ] + }, + { + "id": 3, + "name": "科教/知识", + "fields": [ + { + "id": 3, + "name": "科教/知识" + } + ] + }, + { + "id": 4, + "name": "动画/动漫", + "fields": [ + { + "id": 4, + "name": "动画/动漫" + } + ] + }, + { + "id": 5, + "name": "音乐/舞蹈", + "fields": [ + { + "id": 5, + "name": "音乐/舞蹈" + } + ] + }, + { + "id": 32, + "name": "明星/娱乐", + "fields": [ + { + "id": 32, + "name": "明星/娱乐" + } + ] + }, + { + "id": 35, + "name": "鬼畜", + "fields": [ + { + "id": 35, + "name": "鬼畜" + } + ] + }, + { + "id": 42, + "name": "时尚/健身", + "fields": [ + { + "id": 42, + "name": "时尚/健身" + } + ] + } + ] +} +``` + +-400：请求错误
41023：用户答题记录不存在 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------------- | ----- | ------------------------ | ----------------------------------- | +| hid | num | 答题会话id | | +| mid | num | 答题用户mid | | +| member | num | | | +| score | num | 得分 | | +| level | num | 用户等级 | | +| first_pass | num | | | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| status | str | 答题结果 | failed：未通过
succeed：已通过 | +| question_types | array | 已选择的自选题列表 | | +| power | array | 自选题分类得分情况 | | +| start_time | num | 开始答题时间 | 时间戳 | +| share | obj | | | +| can_show_rank_btn | bool | | | +| is_same_user | bool | | | +| view_more | str | | | +| video_info | obj | | | +| main_tids | array | | | +| sub_tids | array | | | +| power_result | null | | | +| score_rate | num | 分数超过平均用户的百分比 | | +| permission | obj | | | +| rewards | null | | | + +**示例：** + +```shell +curl -G 'https://api.bilibili.com/x/answer/v4/result' \ +--data-urlencode 'hid=1615088061307609' \ +-b 'SESSDATA=xxx' +``` + +
+
\ No newline at end of file
diff --git a/docs/note/action.md b/docs/note/action.md
new file mode 100644
index 0000000000..33dbabae0f
--- /dev/null
+++ b/docs/note/action.md
@@ -0,0 +1,135 @@
+# 笔记操作
+
+- [保存视频笔记](#保存视频笔记)
+- [删除视频笔记](#删除视频笔记)
+
+---
+
+## 保存视频笔记
+
+> https://api.bilibili.com/x/note/add
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
+| oid | num | 目标id | 必要 | |
+| oid_type | num | 目标id类型 | 必要 | `0`视频(oid=avid) |
+| note_id | num | 笔记id | 非必要 | 创建时无需此项 |
+| title | str | 笔记标题 | 必要 | |
+| summary | str | 笔记预览文本 | 必要 | |
+| content | str | 笔记正文json序列 | 必要 | 格式见[附表](readme.md#附表-笔记正文序列格式) |
+| tags | str | 笔记跳转标签列表 | 非必要 | |
+| cls | num | 1 | 非必要 | 作用尚不明确 |
+| from | str | 提交类型 | 非必要 | `auto`自动提交查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "hid": 1615088061307609, + "mid": 1386643599, + "member": 0, + "score": 70, + "level": 0, + "first_pass": 0, + "uname": "眉凭铱ひ前非", + "face": "http://i0.hdslb.com/bfs/face/cd83d4cdbfb521455c168eaa181915b40cb664d1.jpg", + "status": "succeed", + "question_types": [ + { + "id": 12, + "name": "策略模拟 " + }, + { + "id": 13, + "name": "角色扮演 " + }, + { + "id": 14, + "name": "音乐体育 " + }, + { + "id": 8, + "name": "动作射击" + }, + { + "id": 9, + "name": "冒险格斗" + } + ], + "power": [ + { + "score": 0, + "name": "动画" + }, + { + "score": 0, + "name": "艺术" + }, + { + "score": 5, + "name": "游戏" + }, + { + "score": 0, + "name": "科技" + }, + { + "score": 0, + "name": "影视" + }, + { + "score": 0, + "name": "鬼畜" + } + ], + "start_time": 1615088061, + "share": { + "content": "", + "short_content": "" + }, + "can_show_rank_btn": false, + "is_same_user": true, + "view_more": "", + "video_info": { + "url": "", + "name": "", + "img": "", + "watch_num": "", + "up_num": "" + }, + "main_tids": [], + "sub_tids": [], + "power_result": null, + "score_rate": 84, + "permission": { + "reply": true, + "color_dm": true + } + } +} +``` + +`save`手动提交
`close`关闭时自动提交 | +| cont_len | num | 正文字数 | 非必要 | | +| platform | str | 平台 | 非必要 | 可为`web` | +| publish | num | 是否公开笔记 | 非必要 | `0`不公开
`1`公开 | +| auto_comment | num | 是否添加到评论区 | 非必要 | `0`不添加
`1`添加 | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | `0`成功
`-101`账号未登录
`-111`csrf校验失败
`-400`请求错误
`79508`该稿件已存在笔记，无法新增
`79513`笔记所属视频不合法 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 数据本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | ------------ | ---- | +| note_id | num | 笔记id | | + +**示例：** + +保存内容为加粗的STRONG的笔记`3809605586518023`于`av970322090` + +```shell +curl 'https://api.bilibili.com/x/note/add' \ +--data-urlencode 'oid=970322090' \ +--data-urlencode 'oid_type=0' \ +--data-urlencode 'note_id=3809605586518023' +--data-urlencode 'title=周刊哔哩哔哩排行榜#543' +--data-urlencode 'summary=STRONG' +--data-urlencode 'content=[{"attributes":{"bold":true},"insert":"STRONG"},{"insert":"\n"}]' +--data-urlencode 'tags=' +--data-urlencode 'cls=1' +--data-urlencode 'from=save' +--data-urlencode 'csrf=xxx' +-b 'SESSDATA=xxx' +``` + +
+
+
+## 删除视频笔记
+
+> https://api.bilibili.com/x/note/del
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------- | ---- | ------------------------ | ------ | ---- |
+| oid | num | 目标稿件avid | 必要 | |
+| note_id | num | 笔记id | 非必要 | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功 查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "note_id": 3809605586518023 + } +} +``` + +-101：账号未登录
-111：csrf校验失败
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +删除稿件`av457253380`下的笔记`4075968478576647` + +```shell +curl 'https://api.bilibili.com/x/note/del' \ +--data-urlencode 'oid=457253380' \ +--data-urlencode 'note_id=4075968478576647' \ +--data-urlencode 'csrf=xxx' +-b 'SESSDATA=xxx' +``` + +
+
diff --git a/docs/note/info.md b/docs/note/info.md
new file mode 100644
index 0000000000..2014a05ed2
--- /dev/null
+++ b/docs/note/info.md
@@ -0,0 +1,315 @@
+# 笔记详细信息
+
+- [查询该稿件是否禁止笔记](#查询该稿件是否禁止笔记)
+- [查询私有笔记内容](#查询私有笔记内容)
+- [查询公开笔记内容](#查询公开笔记内容)
+
+---
+
+## 查询该稿件是否禁止笔记
+
+> https://api.bilibili.com/x/note/is_forbid
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------ | ---- |
+| aid | num | 稿件avid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | `0`成功查看响应示例：
+```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +`-400`请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------------------- | ---- | ------------ | ----------------------------------- | +| forbid_note_entrance | bool | 是否禁止笔记 | `true`禁止笔记
`false`允许笔记 | + +**示例：** + +查询视频稿件`av338677252`是否禁止笔记 + +```shell +curl 'https://api.bilibili.com/x/note/info' \ +--data-urlencode 'aid=338677252' +``` + +
+
+
+## 查询私有笔记内容
+
+> https://api.bilibili.com/x/note/info
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------- | ---- | ---------- | ----------- | -------- |
+| oid | num | 目标id | 必要 | |
+| oid_type | num | 目标id类型 | 必要 | `0`视频(oid=avid) |
+| note_id | num | 笔记id | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | `0`成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "forbid_note_entrance": false + } +} +``` + +`-400`请求错误
`-101`账号未登录
`79502`笔记详情未找到
`79503`笔记正文未找到 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ----- | ---------------- | -------------- | +| arc | obj | 对应视频稿件信息 | | +| audit_status | num | 0 | 作用暂不明确 | +| cid_count | num | 视频分P数 | | +| content | str | 笔记正文json序列 | 格式见[附表](readme.md#附表-笔记正文序列格式) | +| forbid_note_entrance | bool | | | +| pub_reason | str | 公开笔记相关原因 | | +| pub_status | num | 公开笔记状态 | `1`未公开
`2`已公开
`4`退回 | +| pub_version | num | | | +| summary | str | 笔记预览文本 | | +| tags | array | 笔记跳转标签列表 | | +| title | str | 笔记标题 | | + +`data`中的`arc`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ---------- | ----------------- | +| oid | num | 目标id | | +| oid_type | num | 目标id类型 | `0`视频(oid=avid) | +| title | str | 视频标题 | | +| pic | str | 视频封面 | | +| status | num | | | +| desc | str | 视频简介 | | + +`data`中的`tags`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | ---------------- | +| 0 | obj | 标签1 | | +| n | obj | 标签（n+1） | 按照笔记中位置排列 | +| …… | obj | …… | …… | + +`tags`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ----------------- | ------------ | +| cid | num | 视频cid | | +| status | num | 0 | 作用尚不明确 | +| index | num | 在稿件中的分P索引 | | +| seconds | num | 视频进度 | | +| pos | num | 笔记中位置 | | + +**示例：** + +查询视频`av338677252`中笔记`24508729145690112`的内容 + +```shell +curl 'https://api.bilibili.com/x/note/info' \ +--data-urlencode 'oid=338677252' \ +--data-urlencode 'oid_type=0' \ +--data-urlencode 'note_id=24508729145690112' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询公开笔记内容
+
+> https://api.bilibili.com/x/note/publish/info
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------ | ------ | -------- |
+| cvid | num | 笔记对应的专栏cvid | 必要 | 非笔记id |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ---------------------------------------------------------- |
+| code | num | 返回值 | `0`成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "title": "2022哔哩哔哩拜年纪", + "summary": " ...", + "content": "[{"insert":"\n"}]", + "cid_count": 0, + "audit_status": 0, + "pub_status": 0, + "pub_reason": "", + "pub_version": 0, + "forbid_note_entrance": false, + "tags": [], + "arc": { + "oid": 338677252, + "title": "2022哔哩哔哩拜年纪", + "status": 0, + "oid_type": 0, + "pic": "http://i2.hdslb.com/bfs/archive/1e683a5363f35aa0a65419dbf145177099e38f90.jpg", + "desc": "" + } + } +} +``` + +`-400`请求错误
`79514`公开笔记详情未找到 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------------------- | ----- | ---------------------- | --------------------------------------------- | +| cvid | num | 公开笔记对应的专栏cvid | | +| note_id | num | 笔记id | | +| title | str | 笔记标题 | | +| summary | str | 笔记预览 | | +| content | str | 笔记正文json序列 | 格式见[附表](readme.md#附表-笔记正文序列格式) | +| cid_count | num | (?) | | +| pub_status | num | 公开状态 | | +| tags | array | | | +| arc | obj | 稿件信息 | | +| author | obj | 作者信息 | | +| forbid_note_entrance | bool | | | + +`data`中的`arc`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ---------- | ----------------- | +| oid | num | 目标id | | +| oid_type | num | 目标id类型 | `0`视频(oid=avid) | +| title | str | 标题 | | +| status | num | (?) | | +| pic | str | 封面url | | +| desc | str | 简介 | | + +`data`中的`author`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ---------- | ---- | +| mid | num | 用户mid | | +| name | str | 昵称 | | +| face | str | 头像url | | +| level | num | 用户等级 | | +| vip_info | obj | 会员信息 | | +| pendant | obj | 头像框信息 | | + +**示例：** + +查看公开笔记`cv15160286`的信息 + +```shell +curl 'https://api.bilibili.com/x/note/publish/info' \ +--data-urlencode 'cvid=15160286' +``` + +
+
diff --git a/docs/note/list.md b/docs/note/list.md
new file mode 100644
index 0000000000..0efe5843d9
--- /dev/null
+++ b/docs/note/list.md
@@ -0,0 +1,660 @@
+# 笔记列表
+
+- [查询稿件私有笔记](#查询稿件私有笔记)
+- [查询用户私有笔记](#查询用户私有笔记)
+- [查询稿件公开笔记](#查询稿件公开笔记)
+- [查询用户公开笔记](#查询用户公开笔记)
+
+---
+
+## 查询稿件私有笔记
+
+> https://api.bilibili.com/x/note/list/archive
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+该接口只能查询私有笔记，无法查询公开笔记
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| -------- | ---- | ------------------------ | ------ | ----------------- |
+| oid | num | 目标id | 必要 | |
+| oid_type | num | 目标id类型 | 必要 | `0`视频(oid=avid) |
+| csrf | str | CSRF Token（位于cookie） | 非必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "cvid": 15160286, + "note_id": 24114044116402190, + "title": "2022哔哩哔哩拜年纪", + "summary": "我决定再重新做一个系列，叫做影评系列 那么我们这一次是影系列的第n期 我也不知道是多少期，到时候回去统计一下 今天的影评是写，2022年哔哩哔哩拜年纪 【...", + "content": "[{"insert":"我决定再重新做一个系列，叫做影评系列\n那么我们这一次是影系列的第n期\n我也不知道是多少期，到时候回去统计一下\n今天的影评是写，2022年哔哩哔哩拜年纪\n【以及往年的拜年祭，会提一下】\n看完哔哩哔哩拜年纪之后，我的触动真的很大，那今天就先写哔哩哔哩拜年纪吧。\n字数同样有点长，希望看过2022哔哩哔哩拜年纪的人可以认真看完吧！也可以说说你的想法啊！\n\n首先先说一说它的时间，因为每次都在除夕夜播放而出现要和家人看春晚，又要去抢红包之类的，所以每次都看不了直播。这一点就很糟心了。\n所以说这次同往年一样，我也是看的回放。\n一\n一开始是2233跳舞，因为我不太关注这些二次元，所以说就不详细评述了\n但是这个和去年的不问天，应该是一个系列的。都是2233在一起出镜，然后配的是一首歌，但是我觉得这首歌确实没有不问天那么惊艳我了。\n【我觉得很大的可能是今年的作曲没有泡泡老师，去年，前年的泡泡老师作的曲都真的非常的好听，而且今年的拜年纪的预告片上也有一个三首他写的歌的串烧。真的很不错。】\n二\n然后就说一下\n今年以及往年的动画\n这个主体动画真的每年做的都很不错。就是既有意义，又有故事，还有深度，同时还介绍了风俗人情和乡土民俗，真的都是非常非常好的动画，并且动画制作也很精良。\n真的想知道这些动画的主创人员都是谁，可是每次都没有标注。\n【既然谈到动画，就来说一下去年预告的一个动画叫盒中之海。其实我本来是去年看拜年纪的时候是没有看到这个预告片的\n但是今年的评论区底下，几乎每一个评论区中都在催盒中之海，于是我便去看了一下。我发现这个真的变得更有意义和深度了。\n他讲的是一个游戏，还有海神等等\n虽然感觉到它的预告片很乱，但是总觉得其中有什么联系？就是很悬疑又很惊恐但一看就很有深度的动画了！\n所以我也期待着了！】\n今年讲的是哔哩楼的故事，我觉得他的那个创意真的很好，就是自助餐厅的创意\n可以让每一个人都尝到厨师的快乐，\n但又不是真正去做厨师，如果真的能有这样一家店就好了！\n然后拜年纪传统的视频串烧节目就不说了吧。\n三\n再后来就是新春小记，俗称的是拜年曲\n去年的拜年曲是吉祥话，我觉得两个都很好听，但是说去年的都是我认识并且比较喜欢的歌手，可以今年的歌手一个都不认识了[em]e107[/em]\n但是近两年的但连许都用了说话开篇，然后其中高潮的时候都是顶针的方式来演唱，可能这也是一个习俗吧，但真的还比较好听！\n四\n一些没有触动的作品就不说了\n所以接下来是灯火！\n我没有想到今年过年能再一次听到\n《灯火里的中国》！\n因为今年春晚没有周深还有些遗憾呢！\n但虽然这首歌不是周深唱的，但也温暖人心！\n这个应该与去年的《我的祖国》是一个系列的！\n五\n四迹老师的动画一如既往的有意思\n【但就是少了灵魂快板……】\n去年和前年的快板真的深入人心了！\n所以我还是最喜欢去年的\n“这个好诶！”\n六\n邪教老师好几年没有写燃曲了哈哈哈哈哈哈\n但这个风灵玉秀和拜年祭一起做的动画挺好的\n虽然我不知道风灵玉秀是什么动画\n但武侠版的这个动画的动作做的很细致\n又不是很快，看的舒服又清晰\n配上音乐……\n【我不在想再说还不错了哈哈哈哈哈哈哈】\n七\n终于到我最喜欢的一首人演唱的歌曲\n【哈哈哈哈哈为了不与卡农冲突】\n《快乐手帐》\n我要把纳兰寻风的词吹爆！！！！！！！！！\n“跟着我，哒哒哒哒，搭个舞台\n跟着我，哒哒哒哒，大步迈开”\n“生活就是平平淡淡，偶尔磕磕绊绊\n让脑筋多转转，往好处看看！”\n真的好温暖！积极向上！向前看！\n这个初音未来的声音也没有不适感了！\n这个真的好棒！\n八\n然后是沃玛！\n沃玛的脑回路真的很独特！\n他的这个系列是视频真的很独特又新奇！\n这个不好描述……自己去看吧！\n沃玛的声音也好听！哈哈哈哈哈哈哈\n九\n魔术跳过吧\n上面是这次拜年级我最喜欢的一个节目，第大调卡农。\n这个真的很温暖，还有小提琴和钢琴的两个二重奏，就是非常的震撼人心，很感动。\n再配上他的画面，从一个小孩儿到最后的老人，感觉这一生都可以用这首歌来概括。所以说真的很感动又很温暖，\n而且这个节目的副标题是：\n致敬一生中每一个重要时刻\n所以更感动了！\n十\n拜年祭燃曲《弈》\n意境真的很扩大，不看注释完全看不懂词啊\n但去还比较好听，但感觉没有去年的《万象霜天》惊艳\n那我在b站上面看到一个视频，把这八年的八个燃曲在一起放，然后《弈》真的听起来很明显，很明显。\n高潮很高，很好听！\n所以苍穹是sv还是v啊？\n十一\n这次cilicili的《另一个我》没有做好\n可能是因为去年是《时光盲盒》真的太棒了！！！！\n“一遍遍，我回来了！……辛苦了！”\n反而今年的歌没有触动\n这是我唯一一个跳过了大约一分钟的节目\n十二\n后面几个节目都具有讽刺意义\n但那个三年都放的那个讽刺动画系列\n我属实看不懂哈哈哈哈哈哈哈哈\n梗太多了哈哈哈哈哈哈真有些看不懂\n十三\n终于到《除夕》了\n音阙诗听第二次上拜年祭！\n第一次安安和镜子演唱《与梦盛开》\n第二次是音阙诗听团队创作《除夕》\n同样是音阙诗听味啊！\n这次的词写的还不错！\n所以，节日系列开更！\n【但A-SOUL究竟是什么组合，根本没听说过啊】\n十四\n最后一个节目。\n流年如歌，是前年的最后一个节目，但是我那时候还不习惯听V曲，所以说几乎完全就跳过了，那个节目没有听。\n但是这个纳兰寻风作的词，以及这个西门振作的曲，真的配合起来好好听。\n还是要再吹一下纳兰寻风老师的词真的好棒，然后同样和上一个说的一样，温暖，感动，就有积极向上的那种乐观。\n“你是冰雪消融唤醒万物第一缕花香……”\n“湖面上小船儿晃晃岁月长……”\n【但是纳兰寻风老师究竟是做什么的？\n好像经常调教也能看到他哈哈哈哈哈哈\n没有特别关注】\n然后我每次听一听的是泠鸢翻唱的版本，这一次是让刷牙老师来唱的，男声和女声唱有有别样的风味\n这真的就像《难忘今宵》一样，要待在每一场拜年纪嘛?\n新年的那一天晚上都随着流年如歌，进入梦乡！\n人生如梦，流年似水，岁月如歌，\n春夏秋冬，年复一年\n唯有自己不变\n去下一个十年找到属于自己的答案吧！\n哔哩哔哩乾杯！\n\n\n十五【正好是十五哈哈哈哈哈】\n《五十》这个节目是很晚的时候看的\n有些悬疑，甚至有些恐怖，但引起了许多思考\n写太多了，就不详说了……\n【再次期待艾导的《盒中之海》！】\n\n哔哩哔哩( ゜ -゜)つロ 乾杯~\n——今日发布于Q，转到哔哩哔哩！\n"}]", + "cid_count": 0, + "pub_status": 2, + "tags": [], + "arc": { + "oid": 338677252, + "title": "2022哔哩哔哩拜年纪", + "status": 0, + "oid_type": 0, + "pic": "http://i2.hdslb.com/bfs/archive/1e683a5363f35aa0a65419dbf145177099e38f90.jpg", + "desc": "" + }, + "author": { + "mid": 523870870, + "name": "夜达星xxxxxxx", + "face": "http://i1.hdslb.com/bfs/face/2cdfd277e63b6bb1f400ed616b5caf0a04196f28.jpg", + "level": 3, + "vip_info": { + "type": 0, + "status": 0, + "due_date": 0, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "role": 0, + "avatar_subscript_url": "" + }, + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0, + "image_enhance": "", + "image_enhance_frame": "" + } + }, + "forbid_note_entrance": false + } +} +``` + +-400：请求错误
-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | -------- | -------------------------------------------------- | +| noteIds | array | 笔记列表 | 无笔记则无此项
可能后续会允许视频添加多个笔记 | + +`data`中的`noteIds`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------ | ---- | +| 0 | str | 笔记id | | + +**示例：** + +查询视频`av970322090`的笔记id + +```shell +curl 'https://api.bilibili.com/x/note/list/archive' \ +--data-urlencode 'oid=970322090' \ +--data-urlencode 'oid_type=0' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询用户私有笔记
+
+> https://api.bilibili.com/x/note/list
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
+| ps | num | 每页项数 | 必要 | |
+| pn | num | 页码 | 必要 | |
+| csrf | str | CSRF Token（位于cookie） | 非必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code":0, + "message":"0", + "ttl":1, + "data":{ + "noteIds":[ + "3809605586518023" + ] + } +} +``` + +-400：请求错误
-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ------------ | +| list | array | 明细列表 | | +| page | obj | 页面信息 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | ---------------- | +| 0 | obj | 笔记1 | | +| n | obj | 笔记（n+1） | 按照创建顺序排列 | +| …… | obj | …… | …… | + +`list`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------------------- | ---- | ------------ | ------------------------- | +| title | str | 笔记标题 | | +| summary | str | 笔记预览文本 | | +| mtime | str | 提交时间 | YYYY-MM-DD hh:mm | +| arc | obj | 视频信息 | | +| note_id | num | 笔记id | | +| audit_status | num | 0 | 作用尚不明确 | +| web_url | str | 笔记h5页url | | +| note_id_str | str | 笔记id str | | +| message | str | 更新信息 | "更新于 YYYY-MM-DD hh:mm" | +| forbid_note_entrance | bool | (?) | | +| likes | num | 点赞数 | | +| has_like | bool | 是否点赞 | | + +`list`中的`arc`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ------------ | ---------------------- | +| oid | num | 目标id | | +| bvid | str | 稿件bvid | | +| pic | str | 稿件封面图片url | | +| desc | str | 视频简介 | | +| status | num | 0 | | +| oid_type | num | 目标id类型 | `0`视频(oid=avid) | +| aid | num | 稿件avid | | + +`data`中的`page`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ------------ | -------------------- | +| total | num | 笔记总数 | | +| size | num | 每页项数 | | +| num | num | 页码 | | + +**示例：** + +```shell +curl 'https://api.bilibili.com/x/note/list' \ +--data-urlencode 'ps=10' \ +--data-urlencode 'pn=1' +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询稿件公开笔记
+
+> https://api.bilibili.com/x/note/publish/list/archive
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| -------- | ---- | ---------- | ------ | ----------------- |
+| oid | num | 目标id | 必要 | |
+| oid_type | num | 目标id类型 | 必要 | `0`视频(oid=avid) |
+| ps | num | 每页项数 | 必要 | |
+| pn | num | 页码 | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "title": "2022哔哩哔哩拜年纪", + "summary": " ...", + "mtime": "2022-02-16 16:46", + "arc": { + "oid": 338677252, + "bvid": "BV1fR4y1T7aV", + "pic": "http://i2.hdslb.com/bfs/archive/1e683a5363f35aa0a65419dbf145177099e38f90.jpg", + "desc": "愿大家看的开心！新年快乐，虎年大吉，欧气十足，万事顺意！ヾ(≧▽≦*)o", + "status": 0, + "oid_type": 0, + "aid": 338677252 + }, + "note_id": 24508729145690110, + "audit_status": 0, + "web_url": "https://www.bilibili.com/h5/note-app?oid=338677252&oid_type=0&pagefrom=fullpage&navhide=1&-Bct.statusbar.mode=0", + "note_id_str": "24508729145690112", + "message": "更新于 2022-02-16 16:46", + "forbid_note_entrance": false, + "likes": 0, + "has_like": false + } + ], + "page": { + "total": 1, + "size": 10, + "num": 1 + } + } +} +``` + +-400：请求错误
-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------------- | ----- | ------------ | ---- | +| list | array | 公开笔记列表 | | +| page | obj | 页面信息 | | +| show_public_note | bool | | | +| message | str | | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | ---------------- | +| 0 | obj | 笔记1 | | +| n | obj | 笔记（n+1） | 按照创建顺序排列 | +| …… | obj | …… | …… | + +`list`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ---------------------- | ------------------------- | +| cvid | num | 公开笔记对应的专栏cvid | | +| title | str | 笔记标题 | | +| summary | str | 笔记预览 | | +| pubtime | str | 发布时间 | YYYY-MM-DD hh:mm | +| web_url | str | 笔记h5页url | | +| message | str | 更新信息 | "更新于 YYYY-MM-DD hh:mm" | +| author | obj | 作者信息 | | +| likes | num | 点赞数 | | +| has_like | bool | 是否点赞 | 需要登录(Cookie) | + +`list`中的对象中的`author`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ---------- | ---- | +| mid | num | 用户mid | | +| name | str | 昵称 | | +| face | str | 头像url | | +| level | num | 用户等级 | | +| vip_info | obj | 会员信息 | | +| pendant | obj | 头像框信息 | | + +**示例：** + +查询视频`av338677252`的公开笔记列表 + +```shell +curl 'https://api.bilibili.com/x/note/publish/list/archive' \ +--data-urlencode 'oid=338677252' \ +--data-urlencode 'oid_type=0' \ +--data-urlencode 'ps=10' \ +--data-urlencode 'pn=1' +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询用户公开笔记
+
+> https://api.bilibili.com/x/note/publish/list/user
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ---- |
+| ps | num | 每页项数 | 必要 | |
+| pn | num | 页码 | 必要 | |
+| csrf | str | CSRF Token（位于cookie） | 非必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "cvid": 15160286, + "title": "2022哔哩哔哩拜年纪", + "summary": "我决定再重新做一个系列，叫做影评系列 那么我们这一次是影系列的第n期 我也不知道是多少期，到时候回去统计一下 今天的影评是写，2022年哔哩哔哩拜年纪 【...", + "pubtime": "2022-02-07 23:44", + "web_url": "https://www.bilibili.com/h5/note-app/view?cvid=15160286&pagefrom=ugcvideo", + "message": "更新于 2022-02-07 23:44", + "author": { + "mid": 523870870, + "name": "夜达星xxxxxxx", + "face": "http://i1.hdslb.com/bfs/face/2cdfd277e63b6bb1f400ed616b5caf0a04196f28.jpg", + "level": 3, + "vip_info": { + "type": 0, + "status": 0, + "due_date": 0, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "role": 0, + "avatar_subscript_url": "" + }, + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0, + "image_enhance": "", + "image_enhance_frame": "" + } + }, + "likes": 7, + "has_like": false + }, + { + "cvid": 15086217, + "title": "2022哔哩哔哩拜年纪", + "summary": "节目表，多图预警，方便各位时间戳跳转…… 01:20 New Day [图片] 06:32 重返哔哩楼1 [图片] 11:06 嗨，...", + "pubtime": "2022-02-01 20:07", + "web_url": "https://www.bilibili.com/h5/note-app/view?cvid=15086217&pagefrom=ugcvideo", + "message": "更新于 2022-02-01 20:07", + "author": { + "mid": 3810985, + "name": "Remレム22", + "face": "http://i1.hdslb.com/bfs/face/4cce970eb1b9fb8b322d49133a11caa630178728.jpg", + "level": 6, + "vip_info": { + "type": 2, + "status": 1, + "due_date": 1694880000000, + "vip_pay_type": 1, + "theme_type": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 3, + "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png" + }, + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0, + "image_enhance": "", + "image_enhance_frame": "" + } + }, + "likes": 22, + "has_like": false + }, + { + "cvid": 15080841, + "title": "2022哔哩哔哩拜年纪", + "summary": "2022哔哩哔哩拜年纪从厨师的角度开始了故事，而厨师象征着每个人，每一道菜都是每个厨师用汗水耕耘出来的，并且在主线故事中穿插这不同的小故事，代表了近几年生...", + "pubtime": "2022-02-01 10:10", + "web_url": "https://www.bilibili.com/h5/note-app/view?cvid=15080841&pagefrom=ugcvideo", + "message": "更新于 2022-02-01 10:10", + "author": { + "mid": 482114483, + "name": "沐曦mornal", + "face": "http://i2.hdslb.com/bfs/face/cf1ef9c2045e317dfe6dbe8659b6f7a69c7572d5.jpg", + "level": 4, + "vip_info": { + "type": 1, + "status": 1, + "due_date": 1646755200000, + "vip_pay_type": 1, + "theme_type": 0, + "label": { + "path": "", + "text": "大会员", + "label_theme": "vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "", + "role": 1, + "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png" + }, + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0, + "image_enhance": "", + "image_enhance_frame": "" + } + }, + "likes": 7, + "has_like": false + }, + { + "cvid": 15080246, + "title": "2022哔哩哔哩拜年纪", + "summary": "niumniumnium~~~33是我的菜了！ 这次的跨年纪呢确实不同于以往。我发现现代技术确实给类似的活动提供了平台与支持，但是不可否认的是bilibi...", + "pubtime": "2022-02-01 08:59", + "web_url": "https://www.bilibili.com/h5/note-app/view?cvid=15080246&pagefrom=ugcvideo", + "message": "更新于 2022-02-01 08:59", + "author": { + "mid": 1049943541, + "name": "吃瓜的DINGBALL", + "face": "http://i1.hdslb.com/bfs/face/93e7a3826586338e15e5703f9d49bb3bbd0adfa5.jpg", + "level": 2, + "vip_info": { + "type": 1, + "status": 0, + "due_date": 1641744000000, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "role": 0, + "avatar_subscript_url": "" + }, + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0, + "image_enhance": "", + "image_enhance_frame": "" + } + }, + "likes": 10, + "has_like": false + }, + { + "cvid": 15077197, + "title": "2022哔哩哔哩拜年纪", + "summary": "23333333333333333333333333333333333333333333333333333333333333333333333333333...", + "pubtime": "2022-01-31 22:53", + "web_url": "https://www.bilibili.com/h5/note-app/view?cvid=15077197&pagefrom=ugcvideo", + "message": "更新于 2022-01-31 22:53", + "author": { + "mid": 433136442, + "name": "KiBi_3", + "face": "http://i0.hdslb.com/bfs/face/4c11d1419316f14b8b0f5c146d0cd34627955244.jpg", + "level": 2, + "vip_info": { + "type": 0, + "status": 0, + "due_date": 0, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "role": 0, + "avatar_subscript_url": "" + }, + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0, + "image_enhance": "", + "image_enhance_frame": "" + } + }, + "likes": 2, + "has_like": false + }, + { + "cvid": 15077019, + "title": "2022哔哩哔哩拜年纪", + "summary": "2022加油吖！~~~~~~~~~~~~~~~~~~~~~2022加油吖！2022加油吖！2022加油吖！2022加油吖！2022加油吖！2022加油吖！...", + "pubtime": "2022-01-31 22:36", + "web_url": "https://www.bilibili.com/h5/note-app/view?cvid=15077019&pagefrom=ugcvideo", + "message": "更新于 2022-01-31 22:36", + "author": { + "mid": 11283554, + "name": "zhen_____", + "face": "http://i0.hdslb.com/bfs/baselabs/381fcc3865daf85bd6a1ddc4b6dfbd11ba937dc9.jpg", + "level": 6, + "vip_info": { + "type": 2, + "status": 1, + "due_date": 1730736000000, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 3, + "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png" + }, + "pendant": { + "pid": 5459, + "name": "星座系列：巨蟹座", + "image": "http://i2.hdslb.com/bfs/garb/item/a6e5b6b36a4a6c00ca8881ecc837c2aa9ebcb53d.png", + "expire": 0, + "image_enhance": "http://i2.hdslb.com/bfs/garb/item/a6e5b6b36a4a6c00ca8881ecc837c2aa9ebcb53d.png", + "image_enhance_frame": "" + } + }, + "likes": 5, + "has_like": false + } + ], + "page": { + "total": 6, + "size": 10, + "num": 1 + }, + "show_public_note": true, + "message": "" + } +} +``` + +-400：请求错误
-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ----- | -------- | ---- | +| list | array | 明细列表 | | +| page | obj | 页面信息 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | ---------------- | +| 0 | obj | 笔记1 | | +| n | obj | 笔记（n+1） | 按照创建顺序排列 | +| …… | obj | …… | …… | + +`data`中的`page`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | -------- | ---- | +| total | num | 笔记总数 | | +| size | num | 每页项数 | | +| num | num | 页码 | | + +**示例：** + +```shell +curl 'https://api.bilibili.com/x/note/publish/list/user' \ +--data-urlencode 'ps=10' \ +--data-urlencode 'pn=1' +-b 'SESSDATA=xxx' +``` + +
+
diff --git a/docs/note/readme.md b/docs/note/readme.md
new file mode 100644
index 0000000000..dbf0223e12
--- /dev/null
+++ b/docs/note/readme.md
@@ -0,0 +1,159 @@
+# 视频笔记
+
+2020-11-16 B站推出了测试版的功能——"视频笔记"，与视频稿件关联，为富文本模式，可供记录观看视频时的感悟以及视频中的重要内容，目前只可在web端操作
+
+笔记分为私有笔记和公开笔记，一个稿件只能添加一篇私有笔记，但可以公开多篇笔记
+
+公开笔记与【专栏】性质相同，使用`cvid`寻址相应的公开笔记
+
+---
+
+**继续查看：**
+
+- [笔记列表](list.md)
+- [笔记详细信息](info.md)
+- [笔记操作](action.md)
+
+---
+
+## 附表-笔记正文序列格式
+
+根数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ------------- | ---- |
+| 0 | obj | 第1个元素 | |
+| n | obj | 第(n+1)个元素 | |
+| …… | obj | …… | …… |
+
+根数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ---- | ------------ | ------------------- |
+| attributes | obj | 元素属性 | 无属性无此项 |
+| insert | str | 元素内容 | 为跳转/图片时无此项 |
+| insert | obj | 元素跳转信息 | 非跳转/图片时无此项 |
+
+对象中的`attributes`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ---- | ---------- | ------------------------------ |
+| bold | bool | 是否加粗 | |
+| strike | bool | 是否删除线 | |
+| underline | bool | 是否下划线 | |
+| background | str | 背景颜色 | |
+| color | str | 文字颜色 | |
+| list | str | 列表属性 | ordered有序列表/bullet无序列表 |
+| size | str | 文字字号 | |
+
+对象中的`insert`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ---- | -------- | ------ |
+| tag | obj | 跳转标签 | 二选一 |
+| imageUpload | obj | 笔记图片 | 二选一 |
+
+`insert`中的`tag`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | ----------------- | ------------ |
+| cid | num | 视频cid | |
+| status | num | 0 | 作用尚不明确 |
+| index | num | 在稿件中的分P索引 | |
+| seconds | num | 视频进度 | |
+| cidCount | num | 稿件总分P数 | |
+| key | str | 标签创建时间戳 | |
+| title | str | output | 作用尚不明确 |
+
+`insert`中的`imageUpload`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------ | ---- | ---------- | ------------ |
+| url | str | 图片链接 | |
+| status | str | done | 作用尚不明确 |
+| width | num | 图片宽度-2 | |
+
+示例：
+
+以下笔记正文序列包含`字号`、`加粗`、`高亮`、`普通文本`格式
+
+```json
+[
+ {
+ "attributes": {
+ "size": "24px",
+ "bold": true
+ },
+ "insert": "关掉"
+ },
+ {
+ "attributes": {
+ "size": "24px"
+ },
+ "insert": "，"
+ },
+ {
+ "attributes": {
+ "size": "24px",
+ "bold": true
+ },
+ "insert": "关掉"
+ },
+ {
+ "insert": "，"
+ },
+ {
+ "attributes": {
+ "background": "#fff359"
+ },
+ "insert": "一定要"
+ },
+ {
+ "attributes": {
+ "background": "#fff359",
+ "bold": true
+ },
+ "insert": "关掉"
+ },
+ {
+ "insert": "\n再不关掉那些"
+ },
+ {
+ "attributes": {
+ "bold": true
+ },
+ "insert": "网络游戏"
+ },
+ {
+ "insert": "，小孩哪有"
+ },
+ {
+ "attributes": {
+ "bold": true
+ },
+ "insert": "美好的未来"
+ },
+ {
+ "insert": "，哪有"
+ },
+ {
+ "attributes": {
+ "bold": true
+ },
+ "insert": "美好的前程"
+ },
+ {
+ "insert": "，祖国哪有"
+ },
+ {
+ "attributes": {
+ "bold": true
+ },
+ "insert": "栋梁之才"
+ },
+ {
+ "insert": "\n"
+ }
+]
+```
+
diff --git a/docs/other/API_sign.md b/docs/other/API_sign.md
new file mode 100644
index 0000000000..767b12dbdd
--- /dev/null
+++ b/docs/other/API_sign.md
@@ -0,0 +1,84 @@
+# API 签名与鉴权
+
+部分客户端专用的 rest api 存在基于 sign 的鉴权，需要使用规定的`appkey`及其对应的`appsec`与原始请求参数进行签名计算
+
+不同`appkey`对应不同的 app (如客户端、概念版、必剪、漫画、bililink等)
+
+不同平台同 app 也会存在不同的 `appkey`(如安卓端、ios端、TV端等)
+
+同平台同 app 下不同功能也会存在不同的 `appkey`（如登录专用、取流专用等）
+
+**appkey与appsec一一对应**
+
+- [API签名的计算方式](#API签名的计算方式)
+- [已知的APPKey](#已知的APPKey)
+
+---
+
+## API签名的计算方式
+
+首先为参数中添加`appkey`字段，然后按照参数的 key 重新排序，再将重排序后的参数使用 url query 格式序列化拼接与该 appkey 相对应的 appsec (盐值) 进行**md5 hash计算**（32位小写），该 hash 便是 API 签名
+
+为参数尾部增添`sign`字段，它的值为上一步计算所得的 hash，一并作为表单提交
+
+**实例：**
+
+使用 appkey = `1d8b6e7d45233436`, appsec = `560c52ccd288fed045859ed18bffd973` 对如下 `params` 参数进行签名
+
+```python
+import hashlib
+import urllib.parse
+
+def appsign(params, appkey, appsec):
+ '为请求参数进行 api 签名'
+ params.update({'appkey': appkey})
+ params = dict(sorted(params.items())) # 重排序参数 key
+ query = urllib.parse.urlencode(params) # 序列化参数
+ sign = hashlib.md5((query+appsec).encode()).hexdigest() # 计算 api 签名
+ params.update({'sign':sign})
+ return params
+
+appkey = '1d8b6e7d45233436'
+appsec = '560c52ccd288fed045859ed18bffd973'
+params = {
+ 'id':114514,
+ 'str':'1919810',
+ 'test':'いいよ，こいよ',
+}
+signed_params = appsign(params, appkey, appsec)
+query = urllib.parse.urlencode(signed_params)
+print(signed_params)
+print(query)
+```
+
+输出以下内容，分别是进行 api 签名后参数的 dict 以及 url query 格式
+
+```
+{'appkey': '1d8b6e7d45233436', 'id': 114514, 'str': '1919810', 'test': 'いいよ，こいよ', 'sign': '01479cf20504d865519ac50f33ba3a7d'}
+appkey=1d8b6e7d45233436&id=114514&str=1919810&test=%E3%81%84%E3%81%84%E3%82%88%EF%BC%8C%E3%81%93%E3%81%84%E3%82%88&sign=01479cf20504d865519ac50f33ba3a7d
+```
+
+## 已知的APPKey
+
+| appkey | appsec（sign盐值） | 平台 | 应用 | 备注 |
+|------------------|----------------------------------|-----|----------|------|
+| 07da50c9a0bf829f | 25bdede4e1581c836cab73a48790ca6e | 安卓 | 概念版 | |
+| 1d8b6e7d45233436 | 560c52ccd288fed045859ed18bffd973 | 安卓 | 客户端 | 一般用途 |
+| 178cf125136ca8ea | 34381a26236dd1171185c0beb042e1c6 | 安卓 | 概念版 | |
+| 27eb53fc9058f8c3 | c2ed53a74eeefe3cf99fbd01d8c9c375 | ios | 客户端 | 一般用途 |
+| 37207f2beaebf8d7 | e988e794d4d4b6dd43bc0e89d6e90c43 | 安卓 | biliLink | |
+| 4409e2ce8ffd12b8 | 59b43e04ad6965f34319062b478f83dd | TV | 客户端 | |
+| 57263273bc6b67f6 | a0488e488d1567960d3a765e8d129f90 | 安卓 | 客户端 | |
+| 8d23902c1688a798 | 710f0212e62bd499b8d3ac6e1db9302a | 安卓 | 车机版 | |
+| 5dce947fe22167f9 | | 安卓 | 必剪 | |
+| 7d336ec01856996b | a1ce6983bc89e20a36c37f40c4f1a0dd | 安卓 | 概念版 | |
+| 85eb6835b0a1034e | 2ad42749773c441109bdc0191257a664 | | | |
+| 8e16697a1b4f8121 | f5dd03b752426f2e623d7badb28d190a | 安卓 | 国际版 | |
+| aae92bc66f3edfab | af125a0d5279fd576c1b4418a3e8276d | PC | 投稿工具 | |
+| ae57252b0c09105d | c75875c596a69eb55bd119e74b07cfe3 | 安卓 | 国际版 | |
+| bb3101000e232e27 | 36efcfed79309338ced0380abd824ac1 | 安卓 | 国际版 | |
+| bca7e84c2d947ac6 | 60698ba2f68e01ce44738920a0ffe768 | 安卓 | 客户端 | 登录专用 |
+| cc578d267072c94d | ffb6bb4c4edae2566584dbcacfc6a6ad | 安卓 | 轻视频 | |
+| cc8617fd6961e070 | 3131924b941aac971e45189f265262be | 安卓 | 漫画 | |
+| iVGUTjsxvpLeuDCf | aHRmhWMLkdeMuILqORnYZocwMBpMEOdt | 安卓 | 客户端 | 取流专用 |
+| YvirImLGlLANCLvM | JNlZNgfNGKZEpaDTkCdPQVXntXhuiJEM | ios | 客户端 | 取流专用 |
diff --git a/docs/other/bvid_desc.md b/docs/other/bvid_desc.md
new file mode 100644
index 0000000000..8fd476b0ea
--- /dev/null
+++ b/docs/other/bvid_desc.md
@@ -0,0 +1,389 @@
+# bvid说明
+
+2020-03-23 B站推出了全新的稿件视频id`bvid`来接替之前的`avid`，其意义与之相同
+
+详见：
+
+1. [【升级公告】AV号全面升级至BV号（专栏）](https://www.bilibili.com/read/cv5167957)
+2. [【升级公告】AV号全面升级至BV号](https://www.bilibili.com/blackboard/activity-BV-PC.html)
+
+---
+
+- [概述](#概述)
+ - [格式](#格式)
+ - [实质](#实质)
+ - [avid发号方式的变化](#avid发号方式的变化)
+
+- [算法概述](#算法概述)
+ - [av->bv算法](#av->bv算法)
+ - [bv->av算法](#bv->av算法)
+
+- [编程实现](#编程实现)
+
+ - [Python](#Python)
+
+ - [C](#C)
+
+ - [TypeScript](#TypeScript)
+
+ - [Java](#Java)
+
+ - [Kotlin](#Kotlin)
+
+ - [Golang](#Golang)
+
+---
+
+## 概述
+
+### 格式
+
+“bvid”恒为长度为12的字符串，前两个字母为大写“BV”，后10个为base58计算结果
+
+### 实质
+
+“bvid"为“avid”的base58编码，可通过算法进行相互转化
+
+### avid发号方式的变化
+
+从2009-09-09 09:09:09 [av2](https://www.bilibili.com/video/av2)的发布到2020-03-28 19:45:02 [av99999999](https://www.bilibili.com/video/av99999999)的发布B站结束了以投稿时间为顺序的avid发放，改为随机发放avid
+
+~~暗示B站东方要完？泪目~~
+
+## 算法概述
+
+算法以及程序主要参考[知乎@mcfx的回答](https://www.zhihu.com/question/381784377/answer/1099438784)
+
+### av->bv算法
+
+注：本算法及示例程序仅能编码及解码avid<` 29460791296 `，无法验证avid>=` 29460791296 `的正确性
+
+1. a=(avid⊕177451812)+8728348608
+2. 以i为循环变量循环6次b[i]=(a/58^i)%58
+3. 将b[i]中各个数字转换为以下码表中的字符
+
+码表：
+
+> fZodR9XQDSUm21yCkr6zBqiveYah8bt4xsWpHnJE7jL5VG3guMTKNPAwcF
+
+4. 初始化字符串b[i]=`BV1 4 1 7 `
+
+5. 按照以下字符顺序编码表编码并填充至b[i]
+
+字符顺序编码表：
+
+> 0 -> 11
+>
+> 1 -> 10
+>
+> 2 -> 3
+>
+> 3 -> 8
+>
+> 4 -> 4
+>
+> 5 -> 6
+
+
+### bv->av算法
+
+为以上算法的逆运算
+
+## 编程实现
+
+使用Python、C、TypeScript、Java、Kotlin以及Golang作为示例，欢迎社区提交更多例程
+
+### Python
+
+```python
+table = 'fZodR9XQDSUm21yCkr6zBqiveYah8bt4xsWpHnJE7jL5VG3guMTKNPAwcF' # 码表
+tr = {} # 反查码表
+# 初始化反查码表
+for i in range(58):
+ tr[table[i]] = i
+s = [11, 10, 3, 8, 4, 6] # 位置编码表
+XOR = 177451812 # 固定异或值
+ADD = 8728348608 # 固定加法值
+
+def bv2av(x):
+ r = 0
+ for i in range(6):
+ r += tr[x[s[i]]] * 58 ** i
+ return (r - ADD) ^ XOR
+
+def av2bv(x):
+ x = (x ^ XOR) + ADD
+ r = list('BV1 4 1 7 ')
+ for i in range(6):
+ r[s[i]] = table[x // 58 ** i % 58]
+ return ''. join(r)
+
+print(av2bv(170001))
+print(bv2av('BV17x411w7KC'))
+```
+
+输出为：
+
+```
+BV17x411w7KC
+170001
+```
+
+### C
+
+```c
+#include 查看响应示例：
+ + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "page": { + "total": 0, + "size": 10, + "num": 1 + } + } +} +``` + +
+
+
+## 获取服务器端UTC时间
+
+> https://interface.bilibili.com/serverdate.js
+
+*请求方式：GET*
+
+**js回复：**
+
+```js
+window.serverdate = Date.UTC(YYYY, M, D, h, m, s);
+```
+
+**示例：**
+
+```shell
+curl 'https://interface.bilibili.com/serverdate.js'
+```
+
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "now": 1592666471 + } +} +``` + +
+
diff --git a/docs/ranking&dynamic/85videos.md b/docs/ranking&dynamic/85videos.md
new file mode 100644
index 0000000000..206f844f81
--- /dev/null
+++ b/docs/ranking&dynamic/85videos.md
@@ -0,0 +1,199 @@
+
+
+# 入站必刷
+
+[获取入站必刷85个视频](#85videos)
+
+## 获取入站必刷85个视频
+
+> https://api.bilibili.com/x/web-interface/popular/precious
+
+**url参数**
+
+| 字段 | 类型 | 内容 | 必要性 ｜ 备注 |
+| ------- | ----- | -------- | --------------------------- |
+| page | int | 第几页 | 不必要 | 默认为1 |
+| page_size | int | 每一页的视频数 | 不必要 | 可以设为 85 获取所有的视频 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```js +window.serverdate = Date.UTC(2021, 4, 16, 17, 31, 8); +``` +-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 视频列表 | | + +`data` 字段： + +| 字段 | 类型 | 内容 | 备注 | +| - | - | - | - | +| title | string | 标题 | 入站必刷 | +| media_id | int | media_id | | +| explain | string | 解释（概括）| 我不允许还有人没看过这85个宝藏视频！ | +| list | list | 列表 | | + +`data` 中的 `list` 字段： + +| 字段 | 类型 | 内容 | 备注 | +| - | - | - | - | +| aid | int | aid | | +| videos | int | 视频数? | | +| tid | int | 分区 id | | +| tname | string | 分区名称 | | +| copyright | int | 版权 | | +| pic | url | 封面 url | | +| title | string | 标题 | | +| pubdate | int | 发布时间 | 时间戳 | +| ctime | int | 暂不清楚 | 时间戳 | +| desc | string | 简介 | | +| state | int | 暂不清楚 | | +| duration | int | 视频时长 | 单位为秒 | +| mission_id | int | 暂不清楚 | | +| rights | dict | 暂不清楚 | 好像没啥么用 | +| owner | dict | 作者 | | +| stat | dict | 状态 | | +| dynamic | string | 动态发布时写的文字 | | +| cid | int | cid | | +| dimension | dict | 视频的一些属性 | | +| season_id | int | 暂不清楚 | | +| short_link | string | 短链 | | +| short_link_v2 | string | 短链 | 第二版 | +| bvid | string | bvid | | +| season_type | int | 分区 tid? | | +| is_ogv | bool | 暂不清楚 | | +| ogv_info | dict/null? | 暂不清楚 | | +| rcmd_reason | string? | 暂不清楚 | | +| achievement | string | 荣誉概述 | | + +**示例：** + +``` shell +curl 'https://api.bilibili.com/x/web-interface/popular/precious' +``` +
+
diff --git a/docs/ranking&dynamic/dynamic.md b/docs/ranking&dynamic/dynamic.md
new file mode 100644
index 0000000000..941a0b1d65
--- /dev/null
+++ b/docs/ranking&dynamic/dynamic.md
@@ -0,0 +1,199 @@
+# 分区最新视频
+
+- [获取分区最新视频列表](#获取分区最新视频列表)
+
+---
+
+## 获取分区最新视频列表
+
+> https://api.bilibili.com/x/web-interface/dynamic/region
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ------- |
+| pn | num | 页码 | 非必要 | 默认为1 |
+| ps | num | 每页项数 | 非必要 | 默认为5 |
+| rid | num | 目标分区tid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功查看响应事例:
+ +``` json +{ + "code":0, + "message":"0", + "ttl":1, + "data":{ + "title":"入站必刷", + "media_id":496307088, + "explain":"我不允许还有人没看过这85个宝藏视频！", + "list":[ + { + "aid":715024588, + "videos":1, + "tid":233, + "tname":"极客DIY", + "copyright":1, + "pic":"http://i1.hdslb.com/bfs/archive/55ce9a4d1797ec56a0d4ed727f1a279b89ec3664.jpg", + "title":"【才浅】15天花20万元用500克黄金敲数万锤纯手工打造三星堆黄金面具", + "pubdate":1618207101, + "ctime":1618207101, + "desc":"倾家荡产求三连支持！！！请大家帮忙给新系列想个名字，点赞一百万的话制作三星堆黄金权杖，不会真的可以点到一百万吧\nbgm:\n-Old-B - 【Free Beat】侠之道 、于剑飞 - 01 片头曲 帝陵、AniFace - 夜辞秋江", + "state":0, + "duration":717, + "mission_id":16881, + "rights":{ + "bp":0, + "elec":0, + "download":0, + "movie":0, + "pay":0, + "hd5":0, + "no_reprint":1, + "autoplay":1, + "ugc_pay":0, + "is_cooperation":0, + "ugc_pay_preview":0, + "no_background":0, + "arc_pay":0, + "pay_free_watch":0 + }, + "owner":{ + "mid":2200736, + "name":"才疏学浅的才浅", + "face":"http://i2.hdslb.com/bfs/face/1f4819b224cd882025a9a6a5f2c6680c332f37bc.jpg" + }, + "stat":{ + "aid":715024588, + "view":13833908, + "danmaku":215105, + "reply":39792, + "favorite":619513, + "coin":2484204, + "share":122302, + "now_rank":0, + "his_rank":1, + "like":2338710, + "dislike":0 + }, + "dynamic":"倾家荡产求三连！！", + "cid":323723441, + "dimension":{ + "width":1920, + "height":1080, + "rotate":0 + }, + "season_id":19992, + "short_link":"https://b23.tv/BV16X4y1g7wT", + "short_link_v2":"https://b23.tv/BV16X4y1g7wT", + "bvid":"BV16X4y1g7wT", + "season_type":0, + "is_ogv":false, + "ogv_info":null, + "rcmd_reason":"", + "achievement":"央视新华社点赞，博物馆喊话来上班！" + }, + ... and more + ] + } +} +``` +-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ------ | -------- | ---- | +| archives | array | 视频列表 | | +| page | obj | 页面信息 | | + +`data`中的`archives`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---- | +| 0 | obj | 视频1 | | +| n | obj | 视频(n+1) | | +| …… | obj | …… | …… | + +`data`中的`archives`数组中的对象： + +基本同[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的data对象 + +`data`中的`page`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ---------- | ---- | +| count | num | 总计视频数 | | +| num | num | 当前页码 | | +| size | num | 每页项数 | | + +**示例：** + +获取`tid=21`（生活->日常）分区中的2条最新动态视频信息 + +```shell +curl -G 'https://api.bilibili.com/x/web-interface/dynamic/region' \ +--data-urlencode 'rid=21' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
diff --git a/docs/ranking&dynamic/popular.md b/docs/ranking&dynamic/popular.md
new file mode 100644
index 0000000000..f849eb41c1
--- /dev/null
+++ b/docs/ranking&dynamic/popular.md
@@ -0,0 +1,1298 @@
+# 热门视频
+
+- [获取当前热门视频列表](#获取当前热门视频列表)
+
+---
+
+## 获取当前热门视频列表
+
+> https://api.bilibili.com/x/web-interface/popular
+
+_请求方式：GET_
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------ | --------- |
+| pn | num | 页码 | 非必要 | 默认为 1 |
+| ps | num | 每页项数 | 非必要 | 默认为 20 |
+
+>> 注意:当携带Cookie时返回的数据的排行是个性化的
+
+**json 回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "page": { + "num": 1, + "size": 2, + "count": 189 + }, + "archives": [{ + "aid": 56998612, + "videos": 24, + "tid": 21, + "tname": "日常", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/76536be425ed98ba1f1b9aef1ada3a09f94c9f04.jpg", + "title": "操控百万UP主的一天！", + "pubdate": 1562568733, + "ctime": 1561624175, + "desc": "拍这个视频还挺辛苦的，希望大家喜欢的话给个三连叭！", + "state": 0, + "attribute": 536887424, + "duration": 1864, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 0, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0 + }, + "owner": { + "mid": 2206456, + "name": "花少北丶", + "face": "http://i1.hdslb.com/bfs/face/86ef6895a8f88c80f2885e7eb9ba7989db437b93.jpg" + }, + "stat": { + "aid": 56998612, + "view": 2863604, + "danmaku": 82588, + "reply": 5502, + "favorite": 65471, + "coin": 104905, + "share": 5815, + "now_rank": 0, + "his_rank": 12, + "like": 165638, + "dislike": 0 + }, + "dynamic": "你想看的这里都有！", + "cid": 99548502, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "bvid": "BV1Wx411d7jX" + }, { + "aid": 837503204, + "videos": 1, + "tid": 21, + "tname": "日常", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/7025827d8dbfc6139a2d066daa51a08897282534.jpg", + "title": "“都是小人物，就别说什么大话了，活着就行”", + "pubdate": 1585264054, + "ctime": 1585264054, + "desc": "每一位用心生活的小人物，都是各自生活中不平凡的英雄！", + "state": 0, + "attribute": 16512, + "duration": 295, + "mission_id": 12868, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0 + }, + "owner": { + "mid": 350928606, + "name": "彼岸的岛", + "face": "http://i2.hdslb.com/bfs/face/9814b8b6defc045aa07c3bb08e8a30e63afd9f3e.jpg" + }, + "stat": { + "aid": 837503204, + "view": 142239, + "danmaku": 602, + "reply": 702, + "favorite": 4728, + "coin": 4712, + "share": 917, + "now_rank": 0, + "his_rank": 0, + "like": 7700, + "dislike": 0 + }, + "dynamic": "#全能打卡挑战##正能量##感人#", + "cid": 169901162, + "dimension": { + "width": 1280, + "height": 720, + "rotate": 0 + }, + "bvid": "BV1cg4y1a7tB" + }] + } +} +``` + +-400：请求错误 | +| message | str | 错误信息 | 默认为 0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | -------------- | ---- | +| list | array | 视频列表 | | +| no_more | bool | 是否有更多数据 | false：下页还有数据
true：下页没有数据 | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---- | +| 0 | obj | 视频1 | | +| n | obj | 视频(n+1) | | +| …… | obj | …… | …… | + +`data`中的`list`数组中的对象： + +基本同[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的data对象 + + +**示例：** + +获取当前热门视频列表(不携带 Cookie) + +```shell +curl -G 'https://api.bilibili.com/x/web-interface/popular' \ +--data-urlencode 'ps=20' \ +--data-urlencode 'pn=1' +``` + +
+
\ No newline at end of file
diff --git a/docs/ranking&dynamic/ranking.md b/docs/ranking&dynamic/ranking.md
new file mode 100644
index 0000000000..738136276a
--- /dev/null
+++ b/docs/ranking&dynamic/ranking.md
@@ -0,0 +1,959 @@
+# 视频排行榜
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "aid": 260200041, + "videos": 1, + "tid": 212, + "tname": "美食侦探", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/02641bbfadc63f5224834b096cc6c440e14f385f.jpg", + "title": "街头碳水大师：当北方人看到 南方那么多面食…", + "pubdate": 1662198796, + "ctime": 1662198796, + "desc": "想不到这个南方街头，竟把我俩吃到深夜…", + "state": 0, + "duration": 803, + "mission_id": 873400, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 99157282, + "name": "盗月社食遇记", + "face": "http://i1.hdslb.com/bfs/face/c7fb5da587c2ec6b56ad47579933fda34c000457.jpg" + }, + "stat": { + "aid": 260200041, + "view": 295188, + "danmaku": 3590, + "reply": 1465, + "favorite": 3651, + "coin": 12006, + "share": 2039, + "now_rank": 0, + "his_rank": 0, + "like": 39568, + "dislike": 0 + }, + "dynamic": "这玩意怎么可能不好吃呢？！", + "cid": 822798408, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1fe411g7F5", + "short_link_v2": "https://b23.tv/BV1fe411g7F5", + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220903a22ujdxvylswyat3oqlkj8wax_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1fe411g7F5", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "很多人点赞", "corner_mark": 0 } + }, + { + "aid": 472731550, + "videos": 1, + "tid": 17, + "tname": "单机游戏", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/7ebaad047fb96e5d14b8ebb2eabf4b39a4ef10a6.jpg", + "title": "卸载！！！！！", + "pubdate": 1662177000, + "ctime": 1662093287, + "desc": "再见！！！！！", + "state": 0, + "duration": 1090, + "mission_id": 899516, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 546195, + "name": "老番茄", + "face": "http://i0.hdslb.com/bfs/face/bc5ca101313d4db223c395d64779e76eb3482d60.jpg" + }, + "stat": { + "aid": 472731550, + "view": 997762, + "danmaku": 19350, + "reply": 4339, + "favorite": 44208, + "coin": 113024, + "share": 2172, + "now_rank": 0, + "his_rank": 7, + "like": 205331, + "dislike": 0 + }, + "dynamic": "", + "cid": 821658341, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1AK411f7KR", + "short_link_v2": "https://b23.tv/BV1AK411f7KR", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220902a23i8b6s8004xd62mg3z2ol72_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1AK411f7KR", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "20万点赞", "corner_mark": 0 } + }, + { + "aid": 730159604, + "videos": 1, + "tid": 173, + "tname": "桌游棋牌", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/524de9769a0c06d8300950e24b52dbdd7a192613.jpg", + "title": "老板？架空啦！", + "pubdate": 1662188531, + "ctime": 1662184216, + "desc": "希望你喜欢这次的视频，这次玩的是《我是大老板》。\n游戏的规则不算简单:\n轮到你时，你可以选择发起生意;\n当然你也可以选择补充手牌。\n做成生意会需要一些字母，相当于需要有人投资，ABCDEF就是各位投资人;\n身份类的字母是永久的，除非别人用招募牌给挖走;\n手牌中的字母是一次性的。\n为了成功完成生意，你作为老板需要和你的合伙人商量好价钱，完成后按约定分给合伙人。\n当然，失败的生意是挣不到钱的;\n并且，你作为老板可以 决定是否做这单生意。\n数个回合后，摇骰子决定游戏是否结束；\n游戏结束时，钱最多的人就赢了。\n注意", + "state": 0, + "duration": 941, + "mission_id": 917790, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 1, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 3913194, + "name": "高斯Goh", + "face": "http://i0.hdslb.com/bfs/face/d4c65b5c6be3f9d845c15401173f98b130728851.jpg" + }, + "stat": { + "aid": 730159604, + "view": 603101, + "danmaku": 6535, + "reply": 3197, + "favorite": 13123, + "coin": 22361, + "share": 1587, + "now_rank": 0, + "his_rank": 68, + "like": 87913, + "dislike": 0 + }, + "dynamic": "", + "cid": 822547268, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1BD4y1B7ji", + "short_link_v2": "https://b23.tv/BV1BD4y1B7ji", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220903a21dbowrqfua2zw3hxxeffqtt_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1BD4y1B7ji", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "8万点赞", "corner_mark": 1 } + }, + { + "aid": 942708210, + "videos": 1, + "tid": 85, + "tname": "小剧 场", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/fc453b388f94300e69134a67f2f02d3136462c60.jpg", + "title": "【火焰醉枪】卧槽！这火焰枪竟然不是特效，30个小时匠心制作……", + "pubdate": 1662087586, + "ctime": 1662087587, + "desc": "上期做了火焰醉剑后，大家都说想看火焰醉枪，这次熬了两个大夜拍完啦，制作不易，希望大家多多支持啊！", + "state": 0, + "duration": 156, + "mission_id": 926961, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 432083444, + "name": "俩大叔的功夫梦", + "face": "http://i2.hdslb.com/bfs/face/40bfa8df7854402bdecd21a9c7a67bc1bb891637.jpg" + }, + "stat": { + "aid": 942708210, + "view": 1583053, + "danmaku": 2300, + "reply": 1596, + "favorite": 21206, + "coin": 48190, + "share": 3088, + "now_rank": 0, + "his_rank": 13, + "like": 219810, + "dislike": 0 + }, + "dynamic": "【火焰醉枪】卧槽！这火焰枪竟然不是特效，30个小时匠心制作……", + "cid": 821595336, + "dimension": { "width": 3840, "height": 2160, "rotate": 0 }, + "short_link": "https://b23.tv/BV1yW4y1q78t", + "short_link_v2": "https://b23.tv/BV1yW4y1q78t", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220902a2uf2p36okkkd5tj0koh3jk17_firsti.jpg", + "pub_location": "四川", + "bvid": "BV1yW4y1q78t", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "百万播放", "corner_mark": 1 } + }, + { + "aid": 985156462, + "videos": 1, + "tid": 137, + "tname": "明星综合", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/ee633bc1f33e88a08240cb5df19a768c007871fd.jpg", + "title": "【时代少年团】《哪吒》练习室版", + "pubdate": 1662199200, + "ctime": 1662133574, + "desc": "", + "state": 0, + "duration": 254, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 3670216, + "name": "TF家族", + "face": "http://i1.hdslb.com/bfs/face/1c74336b9060d40d0ccf5e8bce7c0de34526b1e3.jpg" + }, + "stat": { + "aid": 985156462, + "view": 180284, + "danmaku": 20822, + "reply": 6925, + "favorite": 4740, + "coin": 6962, + "share": 1052, + "now_rank": 0, + "his_rank": 0, + "like": 28324, + "dislike": 0 + }, + "dynamic": "", + "cid": 822227418, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1yt4y1j7RW", + "short_link_v2": "https://b23.tv/BV1yt4y1j7RW", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220902a23cnqomtt52rac3gi8wbif37_firsti.jpg", + "pub_location": "北京", + "bvid": "BV1yt4y1j7RW", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "明星综合·人气飙升", "corner_mark": 1 } + }, + { + "aid": 857527108, + "videos": 1, + "tid": 230, + "tname": "软件应用", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/9f495c058d7825b8d45f2701b4271affbf17442b.jpg", + "title": "【苏星河】我的这个微信，你们没人用过", + "pubdate": 1661953525, + "ctime": 1661952710, + "desc": "结尾有惊喜！", + "state": 0, + "duration": 654, + "mission_id": 668476, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 598464467, + "name": "苏星河牛通", + "face": "http://i2.hdslb.com/bfs/face/836a17376b6d1c21200310137256c91731045d1b.jpg" + }, + "stat": { + "aid": 857527108, + "view": 6031262, + "danmaku": 10807, + "reply": 7949, + "favorite": 252749, + "coin": 111985, + "share": 20700, + "now_rank": 0, + "his_rank": 1, + "like": 413858, + "dislike": 0 + }, + "dynamic": "", + "cid": 820274225, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1tV4y1H72k", + "short_link_v2": "https://b23.tv/BV1tV4y1H72k", + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220831qn3fp342hh8svfbtvora7zon7_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1tV4y1H72k", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "百万播放", "corner_mark": 1 } + }, + { + "aid": 857678378, + "videos": 1, + "tid": 76, + "tname": "美食制作", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/5007b350acb31aa5f4a14c96190273d5590a6cb2.jpg", + "title": "《 中 式 炸 鸡 》", + "pubdate": 1662197400, + "ctime": 1662135610, + "desc": "三连吗\n谢谢", + "state": 0, + "duration": 248, + "mission_id": 816705, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 337521240, + "name": "记录生活的蛋黄派", + "face": "http://i0.hdslb.com/bfs/face/9ba6c7a0d3a2ebfe9db2f46219ece98e210d0269.jpg" + }, + "stat": { + "aid": 857678378, + "view": 285421, + "danmaku": 5138, + "reply": 1694, + "favorite": 2757, + "coin": 9736, + "share": 763, + "now_rank": 0, + "his_rank": 0, + "like": 56170, + "dislike": 0 + }, + "dynamic": "谢谢", + "cid": 822249262, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1sV4y1p7hB", + "short_link_v2": "https://b23.tv/BV1sV4y1p7hB", + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220903qn1naqorns10fx528qp3fucqw_firsti.jpg", + "pub_location": "广东", + "bvid": "BV1sV4y1p7hB", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "5万点赞", "corner_mark": 1 } + }, + { + "aid": 602403491, + "videos": 1, + "tid": 161, + "tname": "手工", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/01bf653fd89126740b02c421207eb2519ee26f0c.jpg", + "title": "用超轻黏土捏一个小奶牛", + "pubdate": 1661607234, + "ctime": 1661607235, + "desc": "-", + "state": 0, + "duration": 60, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 1160308896, + "name": "大米的摆摊日常", + "face": "http://i0.hdslb.com/bfs/face/2766a97e274c77166d208293c391b08e93cd7793.jpg" + }, + "stat": { + "aid": 602403491, + "view": 1055453, + "danmaku": 3500, + "reply": 2575, + "favorite": 23732, + "coin": 144083, + "share": 3469, + "now_rank": 0, + "his_rank": 42, + "like": 340294, + "dislike": 0 + }, + "dynamic": "", + "cid": 816374904, + "dimension": { "width": 1080, "height": 1920, "rotate": 0 }, + "short_link": "https://b23.tv/BV1pB4y157Bh", + "short_link_v2": "https://b23.tv/BV1pB4y157Bh", + "up_from_v2": 35, + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220827a21lg9szf96xk8r3l38i3jet5_firsti.jpg", + "pub_location": "四川", + "bvid": "BV1pB4y157Bh", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "百万播放", "corner_mark": 1 } + }, + { + "aid": 217678690, + "videos": 1, + "tid": 138, + "tname": "搞笑", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/1b96235f6b4736f79430362f070f96f76741b8a5.jpg", + "title": "离谱到家了！两社恐挑战去7个UP主家零元购！", + "pubdate": 1662177000, + "ctime": 1662154182, + "desc": "感谢大家的观看，这期视频剪了一个月了。希望大家喜 欢\n三十六贱笑说：这期如果点赞40W，直接拍成系列。", + "state": 0, + "duration": 1918, + "mission_id": 753163, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 1, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 285499073, + "name": "东尼ookii", + "face": "http://i2.hdslb.com/bfs/face/456b2bff7e41ab212b74e9019fda1f26362e8723.jpg" + }, + "stat": { + "aid": 217678690, + "view": 976493, + "danmaku": 11559, + "reply": 1995, + "favorite": 8791, + "coin": 37190, + "share": 1776, + "now_rank": 0, + "his_rank": 31, + "like": 133451, + "dislike": 0 + }, + "dynamic": "超 级 离 谱 新 系 列 ！！！", + "cid": 822326594, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1Ja41137BA", + "short_link_v2": "https://b23.tv/BV1Ja41137BA", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220903qn2sc6o94iasldc2uix7nw6kz_firsti.jpg", + "pub_location": "广东", + "bvid": "BV1Ja41137BA", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "13万点赞", "corner_mark": 1 } + }, + { + "aid": 857726292, + "videos": 1, + "tid": 76, + "tname": "美食制作", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/1a9fe65a51c03d69fd1d4d50cff621e7b9112e29.jpg", + "title": "羊 肉 天 花 板", + "pubdate": 1662192000, + "ctime": 1662184515, + "desc": "羊肉串：\n其实我对羊肉串还是有些研究和追求的\n羊肉记得提前泡30分钟淡盐水去 膻味\n腌肉配方：2勺生抽 1勺蚝油 2勺白胡椒粉\n香料配方：半勺白糖 3勺孜然 2勺辣椒面\n同样的配方腌羊肉和香料也可以在家里炒 着着吃", + "state": 0, + "duration": 434, + "mission_id": 912283, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 473524263, + "name": "澳洲阿彭", + "face": "http://i0.hdslb.com/bfs/face/954547cf631e4f986e5f9e3bfd65328600184b6f.jpg" + }, + "stat": { + "aid": 857726292, + "view": 335725, + "danmaku": 951, + "reply": 429, + "favorite": 3672, + "coin": 15611, + "share": 867, + "now_rank": 0, + "his_rank": 0, + "like": 45838, + "dislike": 0 + }, + "dynamic": "千万不要让猫进厨房", + "cid": 822587296, + "dimension": { "width": 3840, "height": 2160, "rotate": 0 }, + "season_id": 28525, + "short_link": "https://b23.tv/BV1tV4y1p7ux", + "short_link_v2": "https://b23.tv/BV1tV4y1p7ux", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220903a21elu6y2vu085u1gh47kqbdb_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1tV4y1p7ux", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "", "corner_mark": 0 } + }, + { + "aid": 815203242, + "videos": 1, + "tid": 216, + "tname": "鬼畜剧场", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/04a85276faffd2f4bd59a4a7f36cf69833af0fc2.jpg", + "title": "科目三：作毙", + "pubdate": 1662114430, + "ctime": 1662114430, + "desc": "看来你 是真想跟我拼一下子", + "state": 0, + "duration": 72, + "mission_id": 870359, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 7518140, + "name": "暂离二度", + "face": "http://i2.hdslb.com/bfs/face/3d31d41810f12de173515f83b150234bb08a6e72.jpg" + }, + "stat": { + "aid": 815203242, + "view": 892126, + "danmaku": 596, + "reply": 877, + "favorite": 13100, + "coin": 13068, + "share": 19249, + "now_rank": 0, + "his_rank": 92, + "like": 57099, + "dislike": 0 + }, + "dynamic": "", + "cid": 821964961, + "dimension": { "width": 1280, "height": 720, "rotate": 0 }, + "short_link": "https://b23.tv/BV1PG4y1r7JX", + "short_link_v2": "https://b23.tv/BV1PG4y1r7JX", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220902a21fhpl3fapghr9lxcwblqxu0_firsti.jpg", + "pub_location": "浙江", + "bvid": "BV1PG4y1r7JX", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "5万点赞", "corner_mark": 1 } + }, + { + "aid": 302736065, + "videos": 1, + "tid": 251, + "tname": "三农", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/a37fd6ed038127d2336d67c7e5726b9c016a0bae.jpg", + "title": "我又开始玩梗了，而且还进去了。", + "pubdate": 1662095667, + "ctime": 1662095667, + "desc": "-", + "state": 0, + "duration": 53, + "mission_id": 840062, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 50316381, + "name": "疆域阿力木", + "face": "http://i0.hdslb.com/bfs/face/05626e28bbbb34f944f28791a75a2cef4f396a6e.jpg" + }, + "stat": { + "aid": 302736065, + "view": 3078837, + "danmaku": 2722, + "reply": 3193, + "favorite": 15765, + "coin": 22301, + "share": 3463, + "now_rank": 0, + "his_rank": 3, + "like": 461326, + "dislike": 0 + }, + "dynamic": "", + "cid": 821690665, + "dimension": { "width": 1080, "height": 1920, "rotate": 0 }, + "short_link": "https://b23.tv/BV19P411V7Kz", + "short_link_v2": "https://b23.tv/BV19P411V7Kz", + "up_from_v2": 36, + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220902qn2fba1mpclsphj2deu0cb5hg_firsti.jpg", + "pub_location": "新疆", + "bvid": "BV19P411V7Kz", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "百万播放", "corner_mark": 1 } + }, + { + "aid": 557636142, + "videos": 1, + "tid": 138, + "tname": "搞笑", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/ff263e883790351a81caa336c372807a8aabd76c.jpg", + "title": "家里有游乐园？【杜海皇】", + "pubdate": 1662180876, + "ctime": 1662180434, + "desc": "希望各位观众老爷们喜欢这期视频！\n喜欢记得点赞/投币/收藏/分享！", + "state": 0, + "duration": 905, + "mission_id": 753163, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 1, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 178029850, + "name": "杜海皇", + "face": "http://i1.hdslb.com/bfs/face/133111338ef9d6ca04515a0b517b2e837bc41e2b.jpg" + }, + "stat": { + "aid": 557636142, + "view": 692389, + "danmaku": 17406, + "reply": 3198, + "favorite": 14095, + "coin": 24362, + "share": 1470, + "now_rank": 0, + "his_rank": 44, + "like": 98582, + "dislike": 0 + }, + "dynamic": "家里有游乐园？", + "cid": 822513886, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1ae4y1d7z8", + "short_link_v2": "https://b23.tv/BV1ae4y1d7z8", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220903a2vmxll1f3m5f532fzheru0f6_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1ae4y1d7z8", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "9万点赞", "corner_mark": 1 } + }, + { + "aid": 217653051, + "videos": 1, + "tid": 138, + "tname": "搞笑", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/f6e7436fc136c6e824d0cdcc527b366417c238b5.jpg", + "title": "不行了，我们真的土飞天了！！！", + "pubdate": 1662197177, + "ctime": 1662195861, + "desc": "宝剑嫂说点赞20W，立马开始学习究极无敌宇宙SSS难度土味舞蹈！！！\n我就不信她能学会！？？\n\n邮箱：baojiansao@163.com\n记得投稿！！等你！！！", + "state": 0, + "duration": 564, + "mission_id": 753163, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 1, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 147166910, + "name": "雨哥到处跑", + "face": "http://i2.hdslb.com/bfs/face/5717b696a212199679c31857b46c3ba5c465ee06.jpg" + }, + "stat": { + "aid": 217653051, + "view": 186234, + "danmaku": 2498, + "reply": 745, + "favorite": 2573, + "coin": 7170, + "share": 1162, + "now_rank": 0, + "his_rank": 0, + "like": 34817, + "dislike": 0 + }, + "dynamic": "究！极！无！敌！宇！宙！\n土！味！之！王！！！", + "cid": 822750256, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1ga41137Gs", + "short_link_v2": "https://b23.tv/BV1ga41137Gs", + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220903a21l7ofzzwi97zg23eqr7n2ur_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1ga41137Gs", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "", "corner_mark": 0 } + }, + { + "aid": 472678228, + "videos": 1, + "tid": 76, + "tname": "美食制作", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/e92f638626a4e7bfff43f0ff72faf35ff914d851.jpg", + "title": "谁能吃空这一盆，立马入职！", + "pubdate": 1662111000, + "ctime": 1662099066, + "desc": "想知道小胖说什么的看到最后！", + "state": 0, + "duration": 220, + "mission_id": 816705, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 11452660, + "name": "p老板开饭了", + "face": "http://i1.hdslb.com/bfs/face/b1c8a639f1773284b3a7ceb00d62c54de1c8f470.jpg" + }, + "stat": { + "aid": 472678228, + "view": 1136045, + "danmaku": 541, + "reply": 1002, + "favorite": 7157, + "coin": 2192, + "share": 1122, + "now_rank": 0, + "his_rank": 65, + "like": 107942, + "dislike": 0 + }, + "dynamic": "完了，暴露了", + "cid": 821731282, + "dimension": { "width": 2160, "height": 3840, "rotate": 0 }, + "season_id": 619430, + "short_link": "https://b23.tv/BV12K411Z7ET", + "short_link_v2": "https://b23.tv/BV12K411Z7ET", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220902a21767eiq3pz6kpdf47u3h6c5_firsti.jpg", + "pub_location": "四川", + "bvid": "BV12K411Z7ET", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "百万播放", "corner_mark": 1 } + }, + { + "aid": 900009457, + "videos": 1, + "tid": 182, + "tname": "影视杂谈", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/533cb2685bcf5e64b29772dc87347466950710bd.jpg", + "title": "别抬头！天上的东西会吃人！2022最新科幻电影！", + "pubdate": 1661943707, + "ctime": 1661943707, + "desc": "《不》", + "state": 0, + "duration": 349, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 688872987, + "name": "侃片大师兄", + "face": "http://i0.hdslb.com/bfs/face/8935b194271d1dac8ce4c99bdbbd80f682d4a939.jpg" + }, + "stat": { + "aid": 900009457, + "view": 2142899, + "danmaku": 763, + "reply": 687, + "favorite": 5943, + "coin": 587, + "share": 238, + "now_rank": 0, + "his_rank": 85, + "like": 77420, + "dislike": 0 + }, + "dynamic": "", + "cid": 819990856, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1EP4y1f71v", + "short_link_v2": "https://b23.tv/BV1EP4y1f71v", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220831qn23b5noftuzwf87zp2nxkfin_firsti.jpg", + "pub_location": "山东", + "bvid": "BV1EP4y1f71v", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "", "corner_mark": 0 } + }, + { + "aid": 645144956, + "videos": 1, + "tid": 208, + "tname": " 校园学习", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/4caba77c0ea7d95292c4e52dcfc1a2807318f068.jpg", + "title": "耗时一个月制作！不想任何学生错过这个视频啊啊！学习方法/中学/大学/研究生/考证/留学/成长/求职 | 开学解惑图鉴", + "pubdate": 1662177900, + "ctime": 1662127479, + "desc": "开学季啦，框框作为B站辅导员，为大家整理实用知识和经验参考，视频中所有的链接如下，如果 有帮助还请大家三连支持一波！！！！\n一、学习干货\n1、学习方法：\nBV1LU4y1g7no、BV14b411h7FM、BV1QX4y157mJ、BV1Ya4y1W7iT 、BV1X3411k7CX、BV1p741127kM\n2、中学学科：\n语文：BV1ZT4113744、BV1zB4y1w7Sk、BV1oE411K7Qq、BV18U4y1m7iV、BV16L4y157iZ\n数学：BV147411K7xu、BV1fJ411R", + "state": 0, + "duration": 439, + "mission_id": 895731, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 40427625, + "name": "取景框看世界", + "face": "http://i0.hdslb.com/bfs/face/0d671560a6dd7f28247b3b7501d404a5b01280ea.jpg" + }, + "stat": { + "aid": 645144956, + "view": 137130, + "danmaku": 1686, + "reply": 597, + "favorite": 23723, + "coin": 10164, + "share": 1411, + "now_rank": 0, + "his_rank": 0, + "like": 20994, + "dislike": 0 + }, + "dynamic": "这是框框给所有学生党送上的开学礼物，你一定会喜欢的(=・ω・=)", + "cid": 822546678, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "season_id": 682687, + "short_link": "https://b23.tv/BV1rY4y1T7Lk", + "short_link_v2": "https://b23.tv/BV1rY4y1T7Lk", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220903a2204tfiy965tnt32zfgxjhwn_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1rY4y1T7Lk", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "", "corner_mark": 0 } + }, + { + "aid": 302509227, + "videos": 1, + "tid": 183, + "tname": "影视剪辑", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/72695f92333cc5c5dcdc5161ba98fa89a8ad081a.jpg", + "title": "“从不拍烂片的导演”", + "pubdate": 1661986407, + "ctime": 1661986407, + "desc": "-", + "state": 0, + "duration": 20, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 241973789, + "name": "柯基剪辑c", + "face": "http://i2.hdslb.com/bfs/face/515688d6b0406ac9c242b3e0fbb36a5feabd50c8.jpg" + }, + "stat": { + "aid": 302509227, + "view": 169278, + "danmaku": 98, + "reply": 285, + "favorite": 9330, + "coin": 2736, + "share": 396, + "now_rank": 0, + "his_rank": 0, + "like": 34129, + "dislike": 0 + }, + "dynamic": "", + "cid": 820560843, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1pP411L7yw", + "short_link_v2": "https://b23.tv/BV1pP411L7yw", + "up_from_v2": 8, + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220901a232uv0w65umpau1641kk1ktt_firsti.jpg", + "pub_location": "江苏", + "bvid": "BV1pP411L7yw", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "", "corner_mark": 0 } + }, + { + "aid": 815038949, + "videos": 1, + "tid": 250, + "tname": "出行", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/f66582af3f5ea12b04d6f2bec1298fca308d33ce.jpg", + "title": "那天，我看到了54岁最帅的模样", + "pubdate": 1661769000, + "ctime": 1661756898, + "desc": "-", + "state": 0, + "duration": 91, + "mission_id": 834125, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 2041168605, + "name": "他叫阿园", + "face": "http://i0.hdslb.com/bfs/face/ee0cee6afda83588c938a5279d47ce66633379e6.jpg" + }, + "stat": { + "aid": 815038949, + "view": 4203035, + "danmaku": 1797, + "reply": 3724, + "favorite": 69671, + "coin": 150880, + "share": 6483, + "now_rank": 0, + "his_rank": 1, + "like": 732835, + "dislike": 0 + }, + "dynamic": "", + "cid": 817949474, + "dimension": { "width": 1080, "height": 1920, "rotate": 0 }, + "short_link": "https://b23.tv/BV1VG4y167tn", + "short_link_v2": "https://b23.tv/BV1VG4y167tn", + "up_from_v2": 36, + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220829a2246h1eks5qvfw17msnqjkun_firsti.jpg", + "pub_location": "浙江", + "bvid": "BV1VG4y167tn", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": " 百万播放", "corner_mark": 1 } + }, + { + "aid": 900245725, + "videos": 1, + "tid": 138, + "tname": "搞笑", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/8e842aef4241d2f0971bfbf8289919f9417a2054.jpg", + "title": "我们管这叫军训，外国人管这叫实兵演习！", + "pubdate": 1662092612, + "ctime": 1662092612, + "desc": "素材来源：各大高校军训名场面！\nBGM：Wake (Live)", + "state": 0, + "duration": 185, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 626297715, + "name": "荒草音乐", + "face": "http://i0.hdslb.com/bfs/face/d7b9ec37a9b159318cbf09d9d2ce43eba6cfaa12.jpg" + }, + "stat": { + "aid": 900245725, + "view": 792824, + "danmaku": 1603, + "reply": 2508, + "favorite": 11174, + "coin": 3072, + "share": 6911, + "now_rank": 0, + "his_rank": 0, + "like": 37460, + "dislike": 0 + }, + "dynamic": "", + "cid": 821649493, + "dimension": { "width": 1920, "height": 1080, "rotate": 0 }, + "short_link": "https://b23.tv/BV1DP4y1o7y1", + "short_link_v2": "https://b23.tv/BV1DP4y1o7y1", + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220902a226id1e9dpruvu1a3ni88cad_firsti.jpg", + "pub_location": "四川", + "bvid": "BV1DP4y1o7y1", + "season_type": 0, + "is_ogv": false, + "ogv_info": null, + "rcmd_reason": { "content": "", "corner_mark": 0 } + } + ], + "no_more": false + } +} +``` +
+
+- [视频排行榜](#视频排行榜)
+ - [获取分区视频排行榜列表](#获取分区视频排行榜列表)
+
+---
+
+## 获取分区视频排行榜列表
+
+> https://api.bilibili.com/x/web-interface/ranking/v2
+
+*请求方式：GET*
+
+获取稿件内容质量，近期的数据前100个稿件，动态更新。
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ------------------------------------- |
+| rid | num | 目标分区tid | 非必要 | |
+| type | str | 未知 | 非必要 | 默认为：all，且为目前唯一已知值。怀疑为稿件类型，但没有找到其他值佐证。 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 视频列表 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --- | --- | --- | --- | +| note | str | “根据稿件内容质量、近期的数据综合展示，动态更新” | 目前恒为此结果 | +| list | list | 视频列表 | 暂无 | + +`list`列表： + +| 项 | 类型 | 内容 | 备注 | +| --- | ---- | --------------- | ---- | +| 0 | obj | 排行榜第1名 | | +| n | obj | 排行榜第(n+1)名 | | +| …… | obj | …… | …… | +| 99 | obj | 排行榜第100名 | | + +`data`列表中的对象： + +可参考[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的data对象。本API对象中所有字段，均可在链接对象中找到。 + +**示例：** + +获取`tid=1`（动画）分区中所有稿件排行榜排行榜 + +```shell +curl -G 'https://api.bilibili.com/x/web-interface/ranking/v2' \ +--data-urlencode 'tid=1' \ +--data-urlencode 'type=all' +``` + +
+
diff --git a/docs/search/hot.md b/docs/search/hot.md
new file mode 100644
index 0000000000..049ad9ce45
--- /dev/null
+++ b/docs/search/hot.md
@@ -0,0 +1,569 @@
+# 默认搜索&热搜
+
+- [获取默认搜索内容（web端）](#获取默认搜索内容web端)
+- [获取热搜列表（web端）](#获取热搜列表web端)
+- [获取热搜列表（手机端）](#获取热搜列表手机端)
+
+---
+
+## 获取默认搜索内容（web端）
+
+> https://api.bilibili.com/x/web-interface/search/default
+
+*请求方式：GET*
+
+默认搜索为搜索框中默认填充内容，用于官方推荐内容，若不输入点击搜索按钮跳转为`url`中的链接
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------- |
+| code | num | 返回值 | 0：成功 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ---- | --------------- | -------------- |
+| seid | str | 搜索seid | |
+| id | num | 默认搜索id | |
+| type | num | 0 | |
+| show_name | str | 显示文字 | |
+| name | str | 空 | |
+| goto_type | num | 跳转类型 | 1：视频 |
+| goto_value | str | 搜索目标id | 视频：稿件avid |
+| url | str | 搜索目标跳转url | |
+
+**示例：**
+
+```shell
+curl 'https://api.bilibili.com/x/web-interface/search/default'
+```
+
+因本API返回对象过多（100个），故不全部展示，使用者可自行尝试。查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "note": "根据稿件内容质量、近期的数据综合展示，动态更新", + "list": [ + { + "aid": 517751921, + "videos": 1, + "tid": 253, + "tname": "动漫杂谈", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/c70d89ce459eb4a501885f7050ee37d94a5944e4.jpg", + "title": "神作之月！十年前的奇迹！新番时光机「2012年10月篇」", + "pubdate": 1668856639, + "ctime": 1668856639, + "desc": "新番时光机，回顾十年前的动画！本期为2012年10月\n\n往期：\nBV1Br4y1y7ri\nBV1Ly4y1s7wp\nBV16r4y1A7w4\nBV1c64y1f7ff\nBV1sA411A7JD\nBV1wT4y1D729\nBV1mR4y1A7Ey\nBV1gB4y1V7sz", + "state": 0, + "duration": 752, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 63231, + "name": "泛式", + "face": "https://i0.hdslb.com/bfs/face/2608aaa45309c77ac88fbfaa40e160b8c7892985.jpg" + }, + "stat": { + "aid": 517751921, + "view": 1156543, + "danmaku": 14224, + "reply": 5601, + "favorite": 28753, + "coin": 58324, + "share": 6548, + "now_rank": 0, + "his_rank": 11, + "like": 136884, + "dislike": 0 + }, + "dynamic": "泛式队长，时光机更新！", + "cid": 896512490, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 21183, + "short_link": "https://b23.tv/BV1Eg411v7a1", + "short_link_v2": "https://b23.tv/BV1Eg411v7a1", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n221119a29spw3xihz66g3aeuae34t8i_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1Eg411v7a1", + "score": 0 + }, + { + "aid": 987795979, + "videos": 1, + "tid": 27, + "tname": "综合", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/6045782867b5dd91196d93324028f3346eed663a.jpg", + "title": "看海贼的和看火影的都沉默了......", + "pubdate": 1668830400, + "ctime": 1668780416, + "desc": "这一期我把之前十多期的火影加海贼王的内容做了个合集，把做得还可以的片段浓缩成这3分钟，有部分重制了，下一次这类型的视频等着绿牛和尼卡路飞出场，在做多一期—。—感觉还可以的话就给我个三连……或者一个免费的赞，谢谢了", + "state": 0, + "duration": 196, + "mission_id": 1074046, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 601674546, + "name": "-夏秋冬-", + "face": "https://i0.hdslb.com/bfs/face/83b4dd8830c24ee73fbc59f0bd974ea37b0a9470.jpg" + }, + "stat": { + "aid": 987795979, + "view": 2098359, + "danmaku": 3460, + "reply": 2393, + "favorite": 33358, + "coin": 54977, + "share": 45656, + "now_rank": 0, + "his_rank": 15, + "like": 116834, + "dislike": 0 + }, + "dynamic": "", + "cid": 895657562, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "short_link": "https://b23.tv/BV1D44y1Q7im", + "short_link_v2": "https://b23.tv/BV1D44y1Q7im", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n221118qn157llqyqytou2d6cypvute8_firsti.jpg", + "pub_location": "广东", + "bvid": "BV1D44y1Q7im", + "score": 0 + }, + { + "aid": 690264225, + "videos": 1, + "tid": 86, + "tname": "特摄", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/f1ff369250c5fa72106e32e3d7862740ba6a3ab9.jpg", + "title": "评分7.0！风评不佳？诚实吐槽特摄电影《新奥特曼》", + "pubdate": 1668860302, + "ctime": 1668860302, + "desc": "点个关注再走哦~", + "state": 0, + "duration": 832, + "mission_id": 1028236, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 730732, + "name": "瓶子君152", + "face": "https://i1.hdslb.com/bfs/face/951d0a41b33e0c73a0460d20ee83c4c62b0da45f.jpg" + }, + "stat": { + "aid": 690264225, + "view": 1503667, + "danmaku": 4718, + "reply": 3816, + "favorite": 20847, + "coin": 49980, + "share": 4100, + "now_rank": 0, + "his_rank": 18, + "like": 131574, + "dislike": 0 + }, + "dynamic": "#动漫杂谈# #新奥特曼# \n新奥特曼这部电影终于也是借着在你B的推出全网首播\n我也终于是蹭到一回热度了\n这次电影其实评价十分的两极化，那么他究竟讲了什么，我又觉得他怎么样呢，答案就在视频中\n本期视频点赞10w投币4w后面做德凯完结吐槽", + "cid": 896556696, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "short_link": "https://b23.tv/BV1S24y1y7yn", + "short_link_v2": "https://b23.tv/BV1S24y1y7yn", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n221119a23dw30m9rx43073w439ptba1_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1S24y1y7yn", + "score": 0 + }, + { + "aid": 690367853, + "videos": 1, + "tid": 47, + "tname": "短片·手书·配音", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/a79fc307134273460bcc2ebcf56569097dcf5537.jpg", + "title": "”B 站 用 户 精 神 现 状 Ⅱ “", + "pubdate": 1668829018, + "ctime": 1668829019, + "desc": "耶 熬夜之后\n准备看柯南去！\n希望这个视频能带给你快乐！\n☆··☆··☆··☆··☆··☆··☆··☆··☆··☆··☆\n\n文案/绘画/配音/剪辑：鸽一品 \n本节目基本保持1-2周1更！如果喜欢的话请一定要多多三连互动哦！\n\n平时我也会在直播间和大家互动发\n直播时间会在动态中发布周表 大概一周五播\n从0开始做V！ 请多多支持！\n\n ☆··☆··☆··☆··☆··☆··☆··☆··☆··☆··☆\n\n感谢你的支持！鸽子也有自己贩售周边的桃宝店啦~\n一品鸽子窝：https://shop409788748.tao", + "state": 0, + "duration": 122, + "mission_id": 1074046, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 11399495, + "name": "鸽一品", + "face": "https://i2.hdslb.com/bfs/face/87f1fca837a16d6bbae552861454b45b1519301e.jpg" + }, + "stat": { + "aid": 690367853, + "view": 1158451, + "danmaku": 2596, + "reply": 338, + "favorite": 11617, + "coin": 3685, + "share": 429, + "now_rank": 0, + "his_rank": 45, + "like": 132542, + "dislike": 0 + }, + "dynamic": "耶 熬夜之后\n准备看柯南去！\n希望这个视频能带给你快乐！", + "cid": 896076372, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 174909, + "short_link": "https://b23.tv/BV1n24y117Zz", + "short_link_v2": "https://b23.tv/BV1n24y117Zz", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n221119a23psu3qlqb6ssz3rae8wrk8s_firsti.jpg", + "pub_location": "浙江", + "bvid": "BV1n24y117Zz", + "score": 0 + }, + { + "aid": 605336408, + "videos": 1, + "tid": 47, + "tname": "短片·手书·配音", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/69ce5bd3ab899d2212e6dab962c8cfa7f41ad5af.jpg", + "title": "【封号斗罗】哔哩哔哩，来封我朋友的号呀！", + "pubdate": 1668830400, + "ctime": 1668823531, + "desc": "我好坏~\n\n后期 可大师 / 桥和你\n封号斗罗 CV 海盐奶糖白露\nBGM Girls Generation-Gee (Instrumental)", + "state": 0, + "duration": 64, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 1, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 20603745, + "name": "其人", + "face": "https://i0.hdslb.com/bfs/face/f5eb49deb5e87dde3f143c5d2d95d3338060ab93.jpg" + }, + "stat": { + "aid": 605336408, + "view": 652606, + "danmaku": 1527, + "reply": 757, + "favorite": 17896, + "coin": 5787, + "share": 762, + "now_rank": 0, + "his_rank": 49, + "like": 118886, + "dislike": 0 + }, + "dynamic": "", + "cid": 895984408, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 780987, + "short_link": "https://b23.tv/BV1u84y1C7w3", + "short_link_v2": "https://b23.tv/BV1u84y1C7w3", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n221119a2tl68uyltrxucgeyufpd33gz_firsti.jpg", + "pub_location": "广东", + "bvid": "BV1u84y1C7w3", + "score": 0 + }, + { + "aid": 220294467, + "videos": 1, + "tid": 24, + "tname": "MAD·AMV", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/f18d4ecf7578e997d870f0aaf83a26e4fc379d2f.jpg", + "title": "【原神夜店风】深 夜 邂 逅~", + "pubdate": 1668827100, + "ctime": 1668770318, + "desc": "希望大家希望 做了蛮久的", + "state": 0, + "duration": 77, + "mission_id": 1060142, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 1, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 1542136, + "name": "三笠・阿克曼", + "face": "http://i1.hdslb.com/bfs/face/871d3db6a329d2b0e1a67c546301a65f9752d62a.jpg" + }, + "stat": { + "aid": 220294467, + "view": 353464, + "danmaku": 594, + "reply": 474, + "favorite": 34617, + "coin": 11816, + "share": 2647, + "now_rank": 0, + "his_rank": 66, + "like": 88222, + "dislike": 0 + }, + "dynamic": "大的来了！#原神##MAD#", + "cid": 895467115, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 330790, + "short_link": "https://b23.tv/BV1d8411j7xK", + "short_link_v2": "https://b23.tv/BV1d8411j7xK", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n221118qntcb67e8mcic613b3frykpxn_firsti.jpg", + "pub_location": "陕西", + "bvid": "BV1d8411j7xK", + "score": 0 + }, + { + "aid": 562862605, + "videos": 1, + "tid": 47, + "tname": "短片·手书·配音", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/1cd7cb6cf45cdbd65b5b2cb85ac48bd045a110bf.jpg", + "title": "【孤独摇滚/手书】给波奇酱穿新衣服~", + "pubdate": 1668816600, + "ctime": 1668798123, + "desc": "小波奇那么漂亮！快给她买新衣服！！\n感谢原画姐姐们把波奇画得那么可爱！！！", + "state": 0, + "duration": 105, + "mission_id": 1074046, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 1, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 1992514, + "name": "纸欣Dream", + "face": "https://i1.hdslb.com/bfs/face/2c09ba55a475fafa1e82eff79869a9580774f1b0.jpg" + }, + "stat": { + "aid": 562862605, + "view": 428030, + "danmaku": 793, + "reply": 854, + "favorite": 24869, + "coin": 25730, + "share": 6026, + "now_rank": 0, + "his_rank": 96, + "like": 48593, + "dislike": 0 + }, + "dynamic": "#孤独摇滚# 给波奇酱换新衣服！！", + "cid": 896737541, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "short_link": "https://b23.tv/BV1fv4y117Qh", + "short_link_v2": "https://b23.tv/BV1fv4y117Qh", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n221119a2usulbe9u89fy3g0479v48y0_firsti.jpg", + "pub_location": "广东", + "bvid": "BV1fv4y117Qh", + "score": 0 + }, + { + "aid": 945304847, + "videos": 1, + "tid": 47, + "tname": "短片·手书·配音", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/76026f6a6d7698fcc5656fb2d7c151dcb4b4ea65.jpg", + "title": "【丧病中配】如果2077的CV来配音《赛博朋克：边缘行者》（第五话）", + "pubdate": 1668843300, + "ctime": 1668836610, + "desc": "本作品为剪辑二创，非商业用途仅供娱乐，喜欢的朋友欢迎去看完整版原片！\n有幸邀请到CV大佬们一起配《赛博朋克：边缘行者》玩，希望大家喜欢。本视频点赞过5万，继续更新第六话，谢谢大家的支持啦！\nCAST：\n大卫：@刘照坤Jock \n露西：CV张琦@Kii崽 \n曼恩：嘟督\n吉米黑咲：@配音演员虞晓旭 \n琦薇：@楼倾司 \n多莉欧：CV张琦@Kii崽 \n田中：@黑石稔 \n校长：@黑石稔 \n葛洛莉亚：CV张琦@Kii崽 \nNCPD（全）：@是没有风的内个无风吖 \n义体医生：嘟督\n夹暴机动队：@菇力", + "state": 0, + "duration": 1034, + "mission_id": 1089377, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 1, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 2403047, + "name": "嘟督不噶油", + "face": "https://i2.hdslb.com/bfs/face/74738ef7c1ff743959908029b4c9d2dd8b5827c6.jpg" + }, + "stat": { + "aid": 945304847, + "view": 397714, + "danmaku": 2559, + "reply": 1513, + "favorite": 16296, + "coin": 39497, + "share": 3686, + "now_rank": 0, + "his_rank": 0, + "like": 54893, + "dislike": 0 + }, + "dynamic": "久等了！丧病中配《赛博朋克：边缘行者》第五话参上！做个好梦，大卫~", + "cid": 896151792, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 751347, + "short_link": "https://b23.tv/BV1gW4y1W7f4", + "short_link_v2": "https://b23.tv/BV1gW4y1W7f4", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n221119a23injccl1ujog874rrzkgjbq_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1gW4y1W7f4", + "score": 0 + }, + { + "aid": 432692681, + "videos": 1, + "tid": 47, + "tname": "短片·手书·配音", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/13b14a9003bd55b842e3d956f951719e37d4698d.jpg", + "title": "✨踏入白色殿堂，你选择谁？✨", + "pubdate": 1668679200, + "ctime": 1668669686, + "desc": "听说国内人均白毛控？\n小狐兔粉毛MEME指路：BV17B4y1J7vW\nBGM：Di Young-Pixel Pig", + "state": 0, + "duration": 45, + "mission_id": 1074046, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 1118188465, + "name": "在下小狐兔", + "face": "https://i1.hdslb.com/bfs/face/182be1a72202ae348f9d39f047d7b13e32798f80.jpg" + }, + "stat": { + "aid": 432692681, + "view": 1167712, + "danmaku": 3754, + "reply": 2080, + "favorite": 88688, + "coin": 53575, + "share": 5869, + "now_rank": 0, + "his_rank": 5, + "like": 170078, + "dislike": 0 + }, + "dynamic": "染头白毛，直接少走60年弯路~", + "cid": 894207559, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 73722, + "short_link": "https://b23.tv/BV1oG411F7B9", + "short_link_v2": "https://b23.tv/BV1oG411F7B9", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n221117a2a2f8je8qiu2724qkdbgwjch_firsti.jpg", + "pub_location": "浙江", + "bvid": "BV1oG411F7B9", + "score": 0 + }, + { + "aid": 262671873, + "videos": 1, + "tid": 47, + "tname": "短片·手书·配音", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/0d03863e63cc426bbc579bcb54433e3c2f412686.jpg", + "title": "《不做》", + "pubdate": 1668598143, + "ctime": 1668598143, + "desc": "咸鱼日常", + "state": 0, + "duration": 40, + "mission_id": 1074046, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 0, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 357538100, + "name": "懒小熊_LXX", + "face": "https://i2.hdslb.com/bfs/face/7cc145cb9831c319f4a20dc560915478561110a8.jpg" + }, + "stat": { + "aid": 262671873, + "view": 1682548, + "danmaku": 384, + "reply": 1984, + "favorite": 51955, + "coin": 21220, + "share": 49865, + "now_rank": 0, + "his_rank": 11, + "like": 231688, + "dislike": 0 + }, + "dynamic": "", + "cid": 893540811, + "dimension": { + "width": 1440, + "height": 1080, + "rotate": 0 + }, + "short_link": "https://b23.tv/BV1RY411d7Sp", + "short_link_v2": "https://b23.tv/BV1RY411d7Sp", + "up_from_v2": 8, + "first_frame": "http://i1.hdslb.com/bfs/storyff/n221116a2qu5s05btpwu93sv0xig9hx5_firsti.jpg", + "pub_location": "湖南", + "bvid": "BV1RY411d7Sp", + "score": 0 + }, + { + "aid": 432645631, + "videos": 1, + "tid": 253, + "tname": "动漫杂谈", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/976382dd53576cc1af0926a31103e5d179cd26b3.jpg", + "title": "童年引爆全国的动画！《小鲤鱼》的最终结局和剧情究竟是什么？【拾荒记#29】", + "pubdate": 1668741505, + "ctime": 1668741505, + "desc": "相关动画：《小鲤鱼历险记》\n关于拾荒记这个栏目，我将在这个系列节目和大家一起在记忆的杂物堆里翻点什么出来\n\n大家还有什么想看我解读的，欢迎在评论区指出，说不定我下期就做了呢", + "state": 0, + "duration": 1945, + "mission_id": 993288, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 3078223, + "name": "野灿baka", + "face": "https://i1.hdslb.com/bfs/face/db80dbe62245bd35b32c293670190bf8ccd47975.jpg" + }, + "stat": { + "aid": 432645631, + "view": 1901441, + "danmaku": 14422, + "reply": 2815, + "favorite": 20903, + "coin": 26252, + "share": 6618, + "now_rank": 0, + "his_rank": 39, + "like": 97232, + "dislike": 0 + }, + "dynamic": "这期下饭很足，做了一个月呢，看个饱！", + "cid": 895004016, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 210289, + "short_link": "https://b23.tv/BV19G411F7iz", + "short_link_v2": "https://b23.tv/BV19G411F7iz", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n221118a23ee03atvk7k4525jkiqwvxo_firsti.jpg", + "pub_location": "广西", + "bvid": "BV19G411F7iz", + "score": 0 + }, + { + "aid": 732840638, + "videos": 1, + "tid": 24, + "tname": "MAD·AMV", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/5bf52f12ed2eb3d3576f6eb4931e82a4f0aec9ce.jpg", + "title": "“ 现 在 开 始 ，电 锯 人 也 要 起 飞 了 ”", + "pubdate": 1668826313, + "ctime": 1668826313, + "desc": "是我低估了特效向MAD的难度，这次做了快一个月才做好（大概是累到很久都不想剪mad的程度。。）\n灵感来自林逸大佬的MAD视频\nbgm：16shots\n这次真的花费巨多心思，希望大家多多三连哇", + "state": 0, + "duration": 121, + "mission_id": 1074046, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 13458092, + "name": "笔龙XDDD", + "face": "https://i2.hdslb.com/bfs/face/fda9b8f0fb9d42c3ed90190b49b7478c87684078.jpg" + }, + "stat": { + "aid": 732840638, + "view": 456933, + "danmaku": 474, + "reply": 497, + "favorite": 16240, + "coin": 20333, + "share": 2288, + "now_rank": 0, + "his_rank": 0, + "like": 42301, + "dislike": 0 + }, + "dynamic": "叩", + "cid": 896032916, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 861825, + "short_link": "https://b23.tv/BV1hD4y1s7fJ", + "short_link_v2": "https://b23.tv/BV1hD4y1s7fJ", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n221119a23flpz3l68ol27195z5warrj_firsti.jpg", + "pub_location": "浙江", + "bvid": "BV1hD4y1s7fJ", + "score": 0 + }, + { + "aid": 520311091, + "videos": 1, + "tid": 25, + "tname": "MMD·3D", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/0b15fe71c25d0c226a96a4ef253cfb946dda3a15.jpg", + "title": "万叶：哥把你揣兜里，你把哥踹沟里", + "pubdate": 1668871911, + "ctime": 1668871911, + "desc": "模型：米哈游/观海子\n渲染：小二今天吃啥啊、克里斯提亚娜\n动作/镜头：CME6大神犬\n原声：伤心欲茄", + "state": 0, + "duration": 16, + "mission_id": 1060142, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 403425503, + "name": "甜甜草酿鸡", + "face": "https://i2.hdslb.com/bfs/face/66eb2201458e7bf1875c6a1da629cf1c887e30fd.jpg" + }, + "stat": { + "aid": 520311091, + "view": 401135, + "danmaku": 206, + "reply": 597, + "favorite": 15559, + "coin": 2623, + "share": 12448, + "now_rank": 0, + "his_rank": 0, + "like": 64094, + "dislike": 0 + }, + "dynamic": "", + "cid": 896780848, + "dimension": { + "width": 1080, + "height": 1920, + "rotate": 0 + }, + "short_link": "https://b23.tv/BV1hM411C7ez", + "short_link_v2": "https://b23.tv/BV1hM411C7ez", + "up_from_v2": 35, + "first_frame": "http://i0.hdslb.com/bfs/storyff/n221119a213u50mtr1xje1pmh9ufufp1_firsti.jpg", + "pub_location": "广东", + "bvid": "BV1hM411C7ez", + "score": 0 + }, + { + "aid": 775289285, + "videos": 1, + "tid": 210, + "tname": "手办·模玩", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/8defd33e5c2dd860ecb46dfef3445aad14a1f7fa.jpg", + "title": "“最帅最强”的“究极体”？万代 MGEX 强袭自由高达 拼装模型【评头论足】", + "pubdate": 1668830154, + "ctime": 1668830154, + "desc": "大家喜欢视频的话多多点赞关注投币哦~\n《评头论足》主要以第一人称的方式去介绍最新上市的模玩产品，给人以把玩在手中最真实的直观感受，为广大模型爱好者选购模型玩具产品提供方便。合作油箱 pinggaoda@qq.com", + "state": 0, + "duration": 1120, + "mission_id": 1080009, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 2029306, + "name": "-评头论足-", + "face": "https://i1.hdslb.com/bfs/face/c20b5d1f044448ff2c5f4dbafc5dc464fdcdbca5.jpg" + }, + "stat": { + "aid": 775289285, + "view": 422301, + "danmaku": 12251, + "reply": 4824, + "favorite": 11219, + "coin": 26475, + "share": 10777, + "now_rank": 0, + "his_rank": 0, + "like": 37206, + "dislike": 0 + }, + "dynamic": "年度关注度超高的MGEX强袭自由，他来了！", + "cid": 896057755, + "dimension": { + "width": 3840, + "height": 2160, + "rotate": 0 + }, + "season_id": 573806, + "short_link": "https://b23.tv/BV1h14y1H7Ls", + "short_link_v2": "https://b23.tv/BV1h14y1H7Ls", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n221119a21mwd5z96o6l7q1tg8gqhh6m_firsti.jpg", + "pub_location": "辽宁", + "bvid": "BV1h14y1H7Ls", + "score": 0 + }, + ] + } +} +``` + +
+
+
+## 获取热搜列表（web端）
+
+> https://s.search.bilibili.com/main/hotword
+
+*请求方式：GET*
+
+榜单每隔固定时间统计一次，请求后返回搜索前10的关键词
+
+带有转义
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| --------- | ----- | ------------ | ------------- |
+| exp_str | str | ？？？ | |
+| code | num | 返回值 | 0：成功 |
+| cost | obj | 详细搜索用时 | 大概是吧？ |
+| seid | str | 搜索seid | |
+| timestamp | num | 榜单统计时间 | 时间戳 |
+| message | str | 错误信息 | 默认为success |
+| list | array | 热搜列表 | |
+
+`list`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ------------ |
+| 0 | obj | 榜单第1名 | |
+| n | obj | 榜单第（n+1）名 | 按照名次顺序 |
+| 10 | obj | 榜单第10名 | 最后一项 |
+
+`list`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ---- | -------- | ------- |
+| status | str | 空 | |
+| hot_id | num | 热词id | 大概是吧？ |
+| keyword | str | 关键词 | |
+| resource_id| num | 资源id | |
+| goto_type | num | 0 | |
+| res | array| null | |
+| show_name | str | 完整关键词| |
+| pos | num | 名次 | 1-10 |
+| word_type | num | 条目属性 | 均返回8 |
+| id | num | 名次 | 1-10 |
+| goto_value | str | 空 | |
+| live_id | array| null | |
+| name_type | str | 空 | |
+| icon | str | 图标url | |
+
+**示例：**
+
+```shell
+curl 'https://s.search.bilibili.com/main/hotword'
+```
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "seid": "17607543598496143098", + "id": 3296036255232726331, + "type": 0, + "show_name": "歪果仁在中国做模特能赚多少钱？", + "name": "", + "goto_type": 1, + "goto_value": "243920322", + "url": "https://www.bilibili.com/video/BV1Tv411q7gx" + } +} +``` + +
+
+
+## 获取热搜列表（手机端）
+
+> https://app.bilibili.com/x/v2/search/trending/ranking
+
+*请求方式：GET*
+
+榜单每隔固定时间统计一次，请求后返回搜索前20的关键词
+
+带有转义
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| --------- | ----- | ------------ | ------------- |
+| code | num | 返回值 | 0：成功 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 返回值 | 默认为1 |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ------------ |
+| trackid | num | | 不知用途 |
+| list | array | 热搜列表 | |
+
+`list`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ------------ |
+| 0 | obj | 榜单第1名 | |
+| n | obj | 榜单第（n+1）名 | 按照名次顺序 |
+| 20 | obj | 榜单第20名 | 最后一项 |
+
+`list`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ---- | -------- | ------- |
+| position | num | 名次 | 1-20 |
+| keyword | str | 关键词 | |
+| show_name | str | 完整关键词| |
+| word_type | num | 条目属性 | 均返回8 |
+| icon | str | 图标url | |
+| hot_id | num | 热词id | 大概是吧？ |
+
+**示例：**
+
+```shell
+curl 'https://app.bilibili.com/x/v2/search/trending/ranking'
+```
+
+查看响应示例：
+ +```json +{ + "exp_str": "8104#8200#8300#8401#8500#5502#6699", + "code": 0, + "cost": { + "reas_request": "0.001895", + "params_check": "0.000127", + "reas_response_format": "0.000098", + "deserialize_response": "0.000080", + "reas_request_format": "0.000076", + "total": "0.002479", + "main_handler": "0.002252" + }, + "seid": "9318821020548476185", + "timestamp": 1596034742, + "message": "success", + "list": [{ + "status": "", + "hot_id": 11003, + "keyword": "流浪地球2刘德华", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "流浪地球2刘德华造型", + "pos": 1, + "word_type": 8, + "id": 1, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "http://i0.hdslb.com/bfs/feed-admin/e9e7a2d8497d4063421b685e72680bf1cfb99a0d.png" + }, + { + "status": "", + "hot_id": 11012, + "keyword": "QQ飞车手游飞跃黄河", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "QQ飞车手游飞跃黄河", + "pos": 2, + "word_type": 8, + "id": 2, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png" + }, + { + "status": "", + "hot_id": 10996, + "keyword": "西工大遭网络攻击最新调查", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "西工大遭网络攻击最新调查", + "pos": 3, + "word_type": 8, + "id": 3, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "http://i0.hdslb.com/bfs/feed-admin/e9e7a2d8497d4063421b685e72680bf1cfb99a0d.png" + }, + { + "status": "", + "hot_id": 11004, + "keyword": "EDG 起诉", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "EDGJieJie已起诉多家企业", + "pos": 4, + "word_type": 8, + "id": 4, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png" + }, + { + "status": "", + "hot_id": 10992, + "keyword": "隐入尘烟", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "隐入尘烟全平台下架", + "pos": 5, + "word_type": 8, + "id": 5, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "http://i0.hdslb.com/bfs/feed-admin/e9e7a2d8497d4063421b685e72680bf1cfb99a0d.png" + }, + { + "status": "", + "hot_id": 10987, + "keyword": "原神半年内最良心封神池", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "原神半年内最良心封神池", + "pos": 6, + "word_type": 8, + "id": 6, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "" + }, + { + "status": "", + "hot_id": 10988, + "keyword": "高校回应设国内首个元宇宙院系", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "高校回应设国内首个元宇宙院系", + "pos": 7, + "word_type": 8, + "id": 7, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "" + }, + { + "status": "", + "hot_id": 10994, + "keyword": "美宇宙飞船成功撞击小行星", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "美宇宙飞船成功撞击小行星", + "pos": 8, + "word_type": 8, + "id": 8, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "" + }, + { + "status": "", + "hot_id": 10991, + "keyword": "你薅的羊毛可能已违法", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "你薅的羊毛可能已违法", + "pos": 9, + "word_type": 8, + "id": 9, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "" + }, + { + "status": "", + "hot_id": 11013, + "keyword": "辛普森一家", + "resource_id": 0, + "goto_type": 0, + "res": [ + + ], + "show_name": "辛普森一家", + "pos": 10, + "word_type": 8, + "id": 10, + "goto_value": "", + "live_id": [ + + ], + "name_type": "", + "icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png" + } + ] +} +``` + +
+
diff --git a/docs/search/search_request.md b/docs/search/search_request.md
new file mode 100644
index 0000000000..9f32448aeb
--- /dev/null
+++ b/docs/search/search_request.md
@@ -0,0 +1,1443 @@
+# 搜索
+
+- [综合搜索（web端）](#综合搜索web端)
+- [分类搜索（web端）](#分类搜索web端)
+
+---
+
+> **B站于2022年8月24日更新了搜索api，增加了一大堆Cookies的校验，如果Cookies不足会返回-412搜索被拦截。如果没有cookies的话，请在搜索之前先GET一遍 https://bilibili.com 以获取cookies**
+
+## 综合搜索（web端）
+
+> https://api.bilibili.com/x/web-interface/search/all/v2
+
+*方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+返回和关键字相关的20条信息
+
+综合搜索为默认搜索方式，主要用于优先搜索用户、影视、番剧、游戏、话题等，并加载第一页的20项相关视频，还用于展示各个类型的结果数目，便于进一步分类搜索
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------- | ---- | ---------------- | ------ | ---- |
+| keyword | str | 需要搜索的关键词 | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "trackid": "12666380188451258075", + "list": [ + { + "position": 1, + "keyword": "流浪地球2刘德华", + "show_name": "流浪地球2刘德华造型", + "word_type": 8, + "icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png", + "hot_id": 11003 + }, + { + "position": 2, + "keyword": "QQ飞车手游飞跃黄河", + "show_name": "QQ飞车手游飞跃黄河", + "word_type": 8, + "icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png", + "hot_id": 11012 + }, + { + "position": 3, + "keyword": "西工大遭网络攻击最新调查", + "show_name": "西工大遭网络攻击最新调查", + "word_type": 8, + "icon": "http://i0.hdslb.com/bfs/feed-admin/e9e7a2d8497d4063421b685e72680bf1cfb99a0d.png", + "hot_id": 10996 + }, + { + "position": 4, + "keyword": "EDG 起诉", + "show_name": "EDGJieJie已起诉多家企业", + "word_type": 8, + "icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png", + "hot_id": 11004 + }, + { + "position": 5, + "keyword": "隐入尘烟", + "show_name": "隐入尘烟全平台下架", + "word_type": 8, + "icon": "http://i0.hdslb.com/bfs/feed-admin/e9e7a2d8497d4063421b685e72680bf1cfb99a0d.png", + "hot_id": 10992 + }, + { + "position": 6, + "keyword": "原神半年内最良心封神池", + "show_name": "原神半年内最良心封神池", + "word_type": 8, + "hot_id": 10987 + }, + { + "position": 7, + "keyword": "高校回应设国内首个元宇宙院系", + "show_name": "高校回应设国内首个元宇宙院系", + "word_type": 8, + "hot_id": 10988 + }, + { + "position": 8, + "keyword": "美宇宙飞船成功撞击小行星", + "show_name": "美宇宙飞船成功撞击小行星", + "word_type": 8, + "hot_id": 10994 + }, + { + "position": 9, + "keyword": "你薅的羊毛可能已违法", + "show_name": "你薅的羊毛可能已违法", + "word_type": 8, + "hot_id": 10991 + }, + { + "position": 10, + "keyword": "火锅店剩锅底重新给顾客", + "show_name": "火锅店剩锅底重新给顾客", + "word_type": 1, + "hot_id": 11014 + }, + { + "position": 11, + "keyword": "海月", + "show_name": "王者海月逆天", + "word_type": 8, + "hot_id": 10999 + }, + { + "position": 12, + "keyword": "周琦重返NBL", + "show_name": "徐静雨评周琦重返NBL", + "word_type": 8, + "icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png", + "hot_id": 11007 + }, + { + "position": 13, + "keyword": "小超梦剑魔连招", + "show_name": "小超梦剑魔QA连招", + "word_type": 8, + "hot_id": 11006 + }, + { + "position": 14, + "keyword": "东八区的先生们已下架", + "show_name": "东八区的先生们已下架", + "word_type": 8, + "hot_id": 10955 + }, + { + "position": 15, + "keyword": "三国杀新武将全惠解", + "show_name": "三国杀新武将全惠解", + "word_type": 8, + "icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png", + "hot_id": 11009 + }, + { + "position": 16, + "keyword": "ALGS训练赛", + "show_name": "ALGS训练赛", + "word_type": 8, + "icon": "http://i0.hdslb.com/bfs/feed-admin/4d579fb61f9655316582db193118bba3a721eec0.png", + "hot_id": 11011 + }, + { + "position": 17, + "keyword": "王者青白蛇皮肤优化", + "show_name": "王者青白蛇皮肤优化", + "word_type": 8, + "hot_id": 11000 + }, + { + "position": 18, + "keyword": "普京授予斯诺登俄公民身份", + "show_name": "普京授予斯诺登俄公民身份", + "word_type": 1, + "hot_id": 10977 + }, + { + "position": 19, + "keyword": "赛诺角色演示", + "show_name": "原神赛诺角色演示", + "word_type": 8, + "hot_id": 10998 + }, + { + "position": 20, + "keyword": "COD19被玩坏了", + "show_name": "COD19被玩坏了", + "word_type": 8, + "hot_id": 10971 + } + ], + "exp_str": "8000#5509#6605#7708" + } +} +``` + +-400：请求错误
-412：请求被拦截 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------------- | ----- | ---------------- | ---------------- | +| seid | str | 搜索id | | +| page | num | 页数 | 固定为1 | +| pagesize | num | 每页条数 | 固定为20 | +| numResults | num | 总条数 | 最大值为1000 | +| numPages | num | 分页数 | 最大值为50 | +| suggest_keyword | str | 空 | **作用尚不明确** | +| rqt_type | str | search | **作用尚不明确** | +| cost_time | obj | 详细搜索用时 | 大概是吧？ | +| exp_list | obj | ？？？ | **作用尚不明确** | +| egg_hit | num | 0 | **作用尚不明确** | +| pageinfo | obj | 分类页数信息 | | +| top_tlist | obj | 分类结果数目信息 | | +| show_column | num | 0 | **作用尚不明确** | +| show_module_list | array | 返回结果类型列表 | | +| result | array | 结果列表 | | + +`data`中的`cost_time`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------------------- | ---- | ---- | ---- | +| params_check | str | | | +| illegal_handler | str | | | +| as_response_format | str | | | +| as_request | str | | | +| save_cache | str | | | +| deserialize_response | str | | | +| as_request_format | str | | | +| total | str | | | +| main_handler | str | | | + +`data`中的`pageinfo`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------------- | ---- | -------- | ---- | +| pgc | obj | - | | +| live_room | obj | 直播数 | | +| photo | obj | 相簿数 | | +| topic | obj | 话题数 | | +| video | obj | 视频数 | | +| user | obj | - | | +| bili_user | obj | 用户数 | | +| media_ft | obj | 电影数 | | +| article | obj | 专栏数 | | +| media_bangumi | obj | 番剧数 | | +| special | obj | - | | +| operation_card | obj | - | | +| upuser | obj | - | | +| movie | obj | - | | +| live_all | obj | - | | +| tv | obj | - | | +| live | obj | 直播间数 | | +| bangumi | obj | - | | +| activity | obj | 活动数 | | +| live_master | obj | - | | +| live_user | obj | 主播数 | | + +`pageinfo`中的所有对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | -------- | ---- | +| numResults | num | 总计数量 | | +| total | num | 总计数量 | | +| pages | num | 分页数量 | | + +`data`中的`top_tlist`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------------- | ---- | -------- | ---- | +| pgc | num | - | | +| live_room | num | 直播数 | | +| photo | num | 相簿数 | | +| topic | num | 话题数 | | +| video | num | 视频数 | | +| user | num | - | | +| bili_user | num | 用户数 | | +| media_ft | num | 电影数 | | +| article | num | 专栏数 | | +| media_bangumi | num | 番剧数 | | +| card | num | - | | +| operation_card | num | - | | +| upuser | num | - | | +| movie | num | - | | +| live_all | num | - | | +| tv | num | - | | +| live | num | 直播间数 | | +| special | num | - | | +| bangumi | num | - | | +| activity | num | 活动数 | | +| live_master | num | - | | +| live_user | num | 主播数 | | + +`data`中的`show_module_list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---- | +| 0 | str | activity | | +| 1 | str | web_game | 游戏 | +| 2 | str | card | | +| 3 | str | media_bangumi | 番剧 | +| 4 | str | media_ft | 电影 | +| 5 | str | bili_user | 用户 | +| 6 | str | user | | +| 7 | str | star | | +| 8 | str | video | 视频 | + +`data`中的`result`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ---- | +| 0 | obj | - | | +| 1 | obj | 游戏结果 | | +| 2 | obj | - | | +| 3 | obj | 番剧结果 | | +| 4 | obj | 电影结果 | | +| 5 | obj | 用户结果 | | +| 6 | obj | - | | +| 7 | obj | - | | +| 8 | obj | 视频结果 | | + +`result`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ----- | -------- | ------------------------------ | +| result_type | str | 结果类型 | 与`result`数组对应的项相同 | +| data | array | 搜索结果 | 结果为该项所对应的对象条目格式 | + +`result`数组中的对象中的`data`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ---------------------------------------- | +| 0 | obj | 搜索结果1 | 对象详情见[搜索结果](search_response.md) | +| n | obj | 搜索结果（n+1） | 按照参数指定的顺序排列 | +| …… | obj | …… | …… | + +**示例：** + +使用综合搜索进行搜索关键字`洛天依` + +```shell +curl -G 'https://api.bilibili.com/x/web-interface/search/all/v2' \ +--data-urlencode 'keyword=洛天依' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+
+
+## 分类搜索（web端）
+
+> https://api.bilibili.com/x/web-interface/search/type
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+根据关键词进行搜索，返回结果每页20项
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
+| search_type | str | 搜索目标类型 | 必要 | 视频：video查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "seid": "8850295244740510044", + "page": 1, + "pagesize": 20, + "numResults": 1000, + "numPages": 50, + "suggest_keyword": "", + "rqt_type": "search", + "cost_time": { + "params_check": "0.000496", + "get upuser live status": "0.002325", + "illegal_handler": "0.000118", + "as_response_format": "0.007020", + "mysql_request": "0.000054", + "as_request": "0.099139", + "as_request_format": "0.002199", + "deserialize_response": "0.000342", + "total": "0.109753", + "main_handler": "0.109041" + }, + "exp_list": { + "5520": true + }, + "egg_hit": 0, + "pageinfo": { + "pgc": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "live_room": { + "numResults": 1, + "total": 1, + "pages": 1 + }, + "photo": { + "numResults": 1000, + "total": 1000, + "pages": 50 + }, + "bili_user": { + "numResults": 548, + "total": 548, + "pages": 28 + }, + "topic": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "video": { + "numResults": 1000, + "total": 1000, + "pages": 50 + }, + "user": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "article": { + "numResults": 1000, + "total": 1000, + "pages": 50 + }, + "media_ft": { + "numResults": 1, + "total": 1, + "pages": 1 + }, + "media_bangumi": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "special": { + "numResults": 14, + "total": 14, + "pages": 1 + }, + "operation_card": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "upuser": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "movie": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "live_all": { + "numResults": 2, + "total": 2, + "pages": 1 + }, + "tv": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "live": { + "numResults": 773, + "total": 773, + "pages": 39 + }, + "bangumi": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "activity": { + "numResults": 0, + "total": 0, + "pages": 0 + }, + "live_master": { + "numResults": 1, + "total": 1, + "pages": 1 + }, + "live_user": { + "numResults": 772, + "total": 772, + "pages": 39 + } + }, + "top_tlist": { + "pgc": 0, + "live_room": 1, + "photo": 1000, + "bili_user": 548, + "topic": 0, + "video": 1000, + "user": 0, + "article": 1000, + "media_ft": 1, + "media_bangumi": 0, + "card": 0, + "operation_card": 0, + "upuser": 0, + "movie": 0, + "tv": 0, + "live": 2, + "special": 14, + "bangumi": 0, + "activity": 0, + "live_master": 1, + "live_user": 772 + }, + "show_column": 0, + "show_module_list": [ + "bili_user", + "user", + "activity", + "web_game", + "card", + "media_bangumi", + "media_ft", + "star", + "video" + ], + "result": [ + { + "result_type": "bili_user", + "data": [ + { + "type": "bili_user", + "mid": 36081646, + "uname": "洛天依", + "usign": "上海禾念Vsinger旗下歌手，世界第一位VOCALOID中文虚拟歌姬。投食请戳：luotianyi@sh-henian.com", + "fans": 1982688, + "videos": 45, + "upic": "//i2.hdslb.com/bfs/face/cc96d1d6bf76f8198263f9083921997ab3a80d8b.jpg", + "verify_info": "", + "level": 6, + "gender": 2, + "is_upuser": 1, + "is_live": 0, + "room_id": 1546736, + "res": [ + { + "aid": 753839250, + "bvid": "BV1Hk4y1B7Cx", + "title": "【洛天依】2020.7.12洛天依生日会", + "pubdate": 1594559234, + "arcurl": "http://www.bilibili.com/video/av753839250", + "pic": "//i2.hdslb.com/bfs/archive/5347eafb5a65ad9a9ffc39063d686772ea1298c4.jpg", + "play": "269428", + "dm": 30648, + "coin": 33838, + "fav": 24066, + "desc": "从2012年一路走至2020年，8年间刻画下的无数回忆，都在生日会上娓娓道来。\n大家的每一次应援，每一条弹幕都无可替代，都凝结着无可比拟的珍贵回忆。\n希望天依的歌声能鼓起每个人心中的勇气，跨过悲伤、无力，去迎接希望。\n愿我们一同携手成长~相扶相伴。\n天依的首张官方数字专辑也已经上线，等你来听。\n试听： BV1Tp4y1S7cu\n购买：https://y.music.163.com/m/album?id=92206376", + "duration": "58:6", + "is_pay": 0, + "is_union_video": 0 + }, + { + "aid": 968772260, + "bvid": "BV1Tp4y1S7cu", + "title": "【洛天依原创曲】万分之一的光", + "pubdate": 1594557008, + "arcurl": "http://www.bilibili.com/video/av968772260", + "pic": "//i1.hdslb.com/bfs/archive/67c6118e4f94bee89b984525ca665fc88c969cac.jpg", + "play": "333322", + "dm": 9323, + "coin": 39961, + "fav": 29818, + "desc": "8年间我们一起经历了许多，有欢乐也有悲伤，有相遇自然也有别离，但曾相处的日子永远那么辉光闪耀。\n感谢你成为我的光芒，而我也会是你万分之一的光。\n\n音乐：ChiliChill\n贝斯：山口進也\n鼓手：口口口口口\n调校：动点P\n弦乐编配：胡静成 / ChiliChill\n小提琴：庞阔 / 张浩\n中提琴：毕芳\n大提琴：郎莹\n监制：人形兎\n出品：Vsinger", + "duration": "4:12", + "is_pay": 0, + "is_union_video": 1 + }, + { + "aid": 883803983, + "bvid": "BV1kK4y1s7Dd", + "title": "洛天依2020官方专辑《Moments》试听PV", + "pubdate": 1594526467, + "arcurl": "http://www.bilibili.com/video/av883803983", + "pic": "//i1.hdslb.com/bfs/archive/2ff004df9d98e2a78531c6400ee8e823fb30e6f4.jpg", + "play": "205340", + "dm": 7748, + "coin": 18792, + "fav": 14222, + "desc": "8是数字也是象征；\n∞是循环也是无限；\n \n音乐给予了我诞生和成长的力量，让我不断汲取养分，直至冲破险阻向阳生长；\n音乐让我更加幸运，在曾经未知的道路上遇见属于我们彼此的蓝色星光；\n那些一路上的美好，我都想和你们一起收集，瞬间即永恒。\n\n--------Staff--------\n作曲：Chilichill / COP / 人形兎 / 纯白P / 花之祭P / 希望索任合资 / 银临 / JUSF周存\n作词： Chilichill / COP / 人形兎 / 果汁凉菜 / 沈病娇 / 南岐 / 冥凰 / ", + "duration": "3:44", + "is_pay": 0, + "is_union_video": 0 + } + ], + "official_verify": { + "type": 0, + "desc": "洛天依官方账号" + }, + "hit_columns": [ + "uname" + ] + } + ] + }, + { + "result_type": "user", + "data": [] + }, + { + "result_type": "activity", + "data": [] + }, + { + "result_type": "web_game", + "data": [] + }, + { + "result_type": "card", + "data": [] + }, + { + "result_type": "media_bangumi", + "data": [] + }, + { + "result_type": "media_ft", + "data": [] + }, + { + "result_type": "star", + "data": [] + }, + { + "result_type": "video", + "data": [ + { + "type": "video", + "id": 753839250, + "author": "洛天依", + "mid": 36081646, + "typeid": "30", + "typename": "VOCALOID·UTAU", + "arcurl": "http://www.bilibili.com/video/av753839250", + "aid": 753839250, + "bvid": "BV1Hk4y1B7Cx", + "title": "【洛天依】2020.7.12洛天依生日会", + "description": "从2012年一路走至2020年，8年间刻画下的无数回忆，都在生日会上娓娓道来。\n大家的每一次应援，每一条弹幕都无可替代，都凝结着无可比拟的珍贵回忆。\n希望天依的歌声能鼓起每个人心中的勇气，跨过悲伤、无力，去迎接希望。\n愿我们一同携手成长~相扶相伴。\n天依的首张官方数字专辑也已经上线，等你来听。\n试听： BV1Tp4y1S7cu\n购买：https://y.music.163.com/m/album?id=92206376", + "arcrank": "0", + "pic": "//i2.hdslb.com/bfs/archive/5347eafb5a65ad9a9ffc39063d686772ea1298c4.jpg", + "play": 269428, + "video_review": 30648, + "favorites": 24066, + "tag": "VSINGER,洛天依生日快乐,2020洛天依生日会,洛天依生日会,VOCALOID,洛天依", + "review": 4391, + "pubdate": 1594559234, + "senddate": 1594559234, + "duration": "58:6", + "badgepay": false, + "hit_columns": [ + "title", + "author", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 102616359 + }, + { + "type": "video", + "id": 753460703, + "author": "低调的黑叔", + "mid": 22065421, + "typeid": "25", + "typename": "MMD·3D", + "arcurl": "http://www.bilibili.com/video/av753460703", + "aid": 753460703, + "bvid": "BV1Zk4y1B7bn", + "title": "【4K/布料/水手服】洛天依 - GimmexGimme", + "description": "喜欢本期4K请点个关注并长按视频下方大拇指一键三连拜托啦这对我真的很重要\n\nModel：\niRon0129/夏夜/Tda様/やまもと/Samsink(机动战士牛肉）\n\nMotion：\nシガー\n\nSailor Suit：\n星音\n\nStage：\nG_Wuuuuu\n\nRenderer：\nToolbag 3\n\nMusic：\n【初音ミク×鏡音リン】Gimme×Gimme【八王子P×Giga】", + "arcrank": "0", + "pic": "//i1.hdslb.com/bfs/archive/d1bd3d4d12b1e115ce82463853ff791a45472f1f.jpg", + "play": 809854, + "video_review": 1189, + "favorites": 47632, + "tag": "自制,3D,TDA,动画,百万剪辑师挑战,洛天依,美腿,舞蹈MMD,4K", + "review": 798, + "pubdate": 1591367468, + "senddate": 1591404973, + "duration": "1:11", + "badgepay": false, + "hit_columns": [ + "title", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 102465557 + }, + { + "type": "video", + "id": 10131337, + "author": "赛亚♂sya", + "mid": 157056, + "typeid": "30", + "typename": "VOCALOID·UTAU", + "arcurl": "http://www.bilibili.com/video/av10131337", + "aid": 10131337, + "bvid": "BV1fx411U7Kg", + "title": "【洛天依原创】自言自语", + "description": "词曲编调绘：Sya；混音：JUSF周存；简介你随便拿个之前的复制粘贴就行", + "arcrank": "0", + "pic": "//i0.hdslb.com/bfs/archive/e5aab7ddab3e060854e420edae6c5282cbe09324.jpg", + "play": 746480, + "video_review": 4665, + "favorites": 49097, + "tag": "黑洛,诚信代投,自言自语,洛天依,VOCALOID中文曲,原创,高级一图流,自x自x,自A自B系列,赛亚♂sya,JUSF周存", + "review": 7310, + "pubdate": 1493282828, + "senddate": 1542308981, + "duration": "4:14", + "badgepay": false, + "hit_columns": [ + "title", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 102432728 + }, + ………… + ] + } + ] + } +} +``` + +番剧：media_bangumi
影视：media_ft
直播间及主播：live
直播间：live_room
主播：live_user
专栏：article
话题：topic
用户：bili_user
相簿：photo | +| keyword | str | 需要搜索的关键词 | 必要 | | +| order | str | 结果排序方式 | 非必要 | 搜索类型为视频、专栏及相簿时：
默认为totalrank
综合排序：totalrank
最多点击：click
最新发布：pubdate
最多弹幕：dm
最多收藏：stow
最多评论：scores
最多喜欢：attention（仅用于专栏）
----------------------------
搜索结果为直播间时：
默认为online
人气直播：online
最新开播：live_time
----------------------------
搜索结果为用户时：
默认为0
默认排序：0
粉丝数：fans
用户等级：level | +| order_sort | num | 用户粉丝数及等级排序顺序 | 非必要 | 仅用于搜索用户
默认为0
由高到低：0
由低到高：1 | +| user_type | num | 用户分类筛选 | 非必要 | 仅用于搜索用户
默认为0
全部用户：0
up主：1
普通用户：2
认证用户：3 | +| duration | num | 视频时长筛选 | 非必要 | 仅用于搜索视频
默认为0
全部时长：0
10分钟以下：1
10-30分钟：2
30-60分钟：3
60分钟以上：4 | +| tids | num | 视频分区筛选 | 非必要 | 仅用于搜索视频
默认为0
全部分区：0
筛选分区：目标分区tid | +| category_id | num | 专栏及相簿分区筛选 | 非必要 | 搜索结果为专栏时：
默认为0
全部分区：0
动画：2
游戏：1
影视：28
生活：3
兴趣：29
轻小说：16
科技：17
--------
搜索结果为相簿时：
默认为0
全部分区：0
画友：1
摄影：2 | +| page | num | 页码 | 非必要 | 默认为1 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误
-412：请求被拦截 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---------------------------------------------------------- | ------------ | ------------------------------ | +| seid | num | 搜索seid | | +| page | num | 当前页码 | | +| pagesize | num | 每页条数 | 固定20 | +| numResults | num | 总条数 | 最大值为1000 | +| numPages | num | 总计分页数 | 最大值为50 | +| suggest_keyword | str | 空 | **作用尚不明确** | +| rqt_type | str | search | **作用尚不明确** | +| cost_time | obj | 详细搜索用时 | 大概 | +| exp_list | obj | ？？？ | **作用尚不明确** | +| egg_hit | num | 0 | **作用尚不明确** | +| pageinfo | obj | 副分页信息 | 只在搜索类型为直播间及主播有效 | +| result | 搜索类型为直播间及主播时：obj
搜索类型为其他时：array | 结果列表 | | +| show_column | num | 0 | **作用尚不明确** | + +`data`中的`cost_time`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------------------- | ---- | ---- | ---- | +| params_check | str | | | +| illegal_handler | str | | | +| as_response_format | str | | | +| as_request | str | | | +| save_cache | str | | | +| deserialize_response | str | | | +| as_request_format | str | | | +| total | str | | | +| main_handler | str | | | + +`data`中的`pageinfo`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | ---------- | ---- | +| live_room | obj | 直播间信息 | | +| live_user | obj | 主播信息 | | + +`pageinfo`中的`live_room`及`live_user`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | -------- | ---- | +| numPages | num | 总计页数 | | +| numResults | num | 总计项数 | | +| total | num | 总计项数 | | +| pages | num | 总计页数 | | + +**搜索类型为直播间及主播时：** + +`data`中的`result`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ----- | ---------- | ---- | +| live_room | array | 直播间信息 | | +| live_user | array | 主播信息 | | + +`result`中的`live_room`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---------------------------------------- | +| 0 | obj | 直播间搜索结果1 | 对象详情见[搜索结果](search_response.md) | +| n | obj | 直播间搜索结果（n+1） | 按照参数指定的顺序排列 | +| …… | obj | …… | …… | + +`result`中的`live_user`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------------- | ---------------------------------------- | +| 0 | obj | 主播搜索结果1 | 对象详情见[搜索结果](search_response.md) | +| n | obj | 主播搜索结果（n+1） | 按照参数指定的顺序排列 | +| …… | obj | …… | …… | + +**搜索类型为其他时：** + +`data`中的`result`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ---------------------------------------- | +| 0 | obj | 搜索结果1 | 对象详情见[搜索结果](search_response.md) | +| n | obj | 搜索结果（n+1） | 按照参数指定的顺序排列 | +| …… | obj | …… | …… | + +**示例：** + +按照关键词` 少年 `搜索视频，默认排序，全部时长，全部分区，第1页 + +```shell +curl -G 'https://api.bilibili.com/x/web-interface/search/type' \ +--data-urlencode 'search_type=video' \ +--data-urlencode 'keyword=少年' \ +--data-urlencode 'order=totalrank' \ +--data-urlencode 'duration=0' \ +--data-urlencode 'tids=0' \ +--data-urlencode 'page=1' \ +-b 'SESSDATA=xxx' +``` + +
+
diff --git a/docs/search/search_response.md b/docs/search/search_response.md
new file mode 100644
index 0000000000..ed064d25e0
--- /dev/null
+++ b/docs/search/search_response.md
@@ -0,0 +1,778 @@
+# 搜索响应条目
+
+本页为搜索结果数组`result`中的对象的说明
+
+---
+
+- [对象类型1-结果为视频](#对象类型1-结果为视频)
+- [对象类型2-结果为番剧&影视](#对象类型2-结果为番剧&影视)
+- [对象类型3-结果为直播间](#对象类型3-结果为直播间)
+- [对象类型4-结果为主播](#对象类型4-结果为主播)
+- [对象类型5-结果为专栏](#对象类型5-结果为专栏)
+- [对象类型6-结果为话题](#对象类型6-结果为话题)
+- [对象类型7-结果为用户](#对象类型7-结果为用户)
+- [对象类型8-结果为相簿](#对象类型8-结果为相簿)
+
+---
+
+## 对象类型1-结果为视频
+
+| 字段 | 类型 | 内容 | 备注 |
+| -------------- | ----- | -------------- | ----------------------------------------- |
+| type | str | 结果类型 | 固定为video |
+| id | num | 结果 | 为稿件avid |
+| author | str | UP主昵称 | |
+| mid | num | UP主mid | |
+| typeid | str | 视频分区tid | |
+| typename | str | 视频子分区名 | |
+| arcurl | str | 视频重定向url | |
+| aid | num | 稿件avid | |
+| bvid | str | 稿件bvid | |
+| title | str | 视频标题 | 关键字用xml标签``标注 |
+| description | str | 视频简介 | |
+| arcrank | str | 0 | **作用尚不明确** |
+| pic | str | 视频封面url | |
+| play | num | 视频播放量 | |
+| video_review | num | 视频弹幕量 | |
+| favorites | num | 视频收藏数 | |
+| tag | str | 视频TAG | 每项TAG用`,`分隔 |
+| review | num | 视频评论数 | |
+| pubdate | num | 视频投稿时间 | 时间戳 |
+| senddate | num | 视频发布时间 | 时间戳 |
+| duration | str | 视频时长 | HH:MM |
+| badgepay | bool | false | **作用尚不明确** |
+| hit_columns | array | 关键字匹配类型 | |
+| view_type | str | 空 | **作用尚不明确** |
+| is_pay | num | 0 | **作用尚不明确** |
+| is_union_video | num | 是否为合作视频 | 0：否查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "seid": "9339963973663795027", + "page": 1, + "pagesize": 20, + "numResults": 1000, + "numPages": 50, + "suggest_keyword": "", + "rqt_type": "search", + "cost_time": { + "params_check": "0.000300", + "illegal_handler": "0.000077", + "as_response_format": "0.003071", + "as_request": "0.072525", + "save_cache": "0.001115", + "deserialize_response": "0.000310", + "as_request_format": "0.000319", + "total": "0.077996", + "main_handler": "0.076419" + }, + "exp_list": { + "5520": true + }, + "egg_hit": 0, + "result": [ + { + "type": "video", + "id": 243082173, + "author": "大橘爱吃猫", + "mid": 178932626, + "typeid": "193", + "typename": "MV", + "arcurl": "http://www.bilibili.com/video/av243082173", + "aid": 243082173, + "bvid": "BV1De411p77r", + "title": "梦然-《少年》官方版", + "description": "https://www.ixigua.com/i6822128361129640462/?logTag=EBTB5DTpBmxcfK1GYOOea\n梦然老师《少年》MV官方版，原版：西瓜视频搜索“抖音梦然-《少年》” 抖音搜索 “《少年》MV梦然。", + "arcrank": "0", + "pic": "//i0.hdslb.com/bfs/archive/e25120857a6298d1d4b9e64a805c023b5143c8ff.jpg", + "play": 1037655, + "video_review": 2616, + "favorites": 27341, + "tag": "华语MV,国语MV,梦然,少年,梦想,成长,循环,热歌", + "review": 1265, + "pubdate": 1588407050, + "senddate": 1588407051, + "duration": "4:18", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 105415949 + }, + { + "type": "video", + "id": 97387124, + "author": "小石头和孩子们", + "mid": 324914635, + "typeid": "31", + "typename": "翻唱", + "arcurl": "http://www.bilibili.com/video/av97387124", + "aid": 97387124, + "bvid": "BV1B7411R7a8", + "title": "你还是从前的那个少年吗？来自元气少女超甜的《少年》", + "description": "", + "arcrank": "0", + "pic": "//i1.hdslb.com/bfs/archive/8502088a888aeb37df7c4bd1b77d57aabae4f4d3.jpg", + "play": 1953494, + "video_review": 5934, + "favorites": 50883, + "tag": "全民音乐UP主,小石头和孩子们,少年,MV,翻唱,音乐推荐", + "review": 2963, + "pubdate": 1584581433, + "senddate": 1584581434, + "duration": "4:1", + "badgepay": false, + "hit_columns": [ + "title", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 101083208 + }, + { + "type": "video", + "id": 200115746, + "author": "似乎一脸懵逼", + "mid": 110939266, + "typeid": "22", + "typename": "鬼畜调教", + "arcurl": "http://www.bilibili.com/video/av200115746", + "aid": 200115746, + "bvid": "BV1Yz411b7A3", + "title": "【马化腾】我还是充钱那个少年，没有一丝丝改变~", + "description": "临时做的小作品\n音源：-提问-", + "arcrank": "0", + "pic": "//i1.hdslb.com/bfs/archive/078a9b50b4df8d25c2f586668741b30348604173.jpg", + "play": 1069066, + "video_review": 3198, + "favorites": 16321, + "tag": "黄绿合战5th-绿队应援,马化腾,鬼畜调教,腾讯,腾讯游戏,QQ,氪金,少年,我还是从前那个少年", + "review": 1438, + "pubdate": 1585650825, + "senddate": 1586310556, + "duration": "1:26", + "badgepay": false, + "hit_columns": [ + "title", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100482941 + }, + { + "type": "video", + "id": 96440301, + "author": "Da圣音乐", + "mid": 353230307, + "typeid": "130", + "typename": "音乐综合", + "arcurl": "http://www.bilibili.com/video/av96440301", + "aid": 96440301, + "bvid": "BV1LE411G7F4", + "title": "最近突然火的《少年》太好听了，单曲循环了很多遍！", + "description": "Hello，大家好，我是阿光\n本期节目为大家盘点三首最近特别火的中文歌曲\n我保证每一首歌都能撩动你的心弦\n来喽，正如：恰同学少年，风华正茂！\n第一首就是歌手梦然发行于2019年的《少年》\n第二首《后会无期》\n第三首《平凡天使》", + "arcrank": "0", + "pic": "//i2.hdslb.com/bfs/archive/bcde6fb455902b367138b7a4026419de0a50a42d.jpg", + "play": 2440158, + "video_review": 2314, + "favorites": 7163, + "tag": "乐评盘点,音乐,少年,后会无期,平凡天使,邓紫棋,热门歌曲,感动,高考,疫情", + "review": 1072, + "pubdate": 1584334818, + "senddate": 1584339026, + "duration": "3:2", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100455675 + }, + { + "type": "video", + "id": 370000842, + "author": "猫耳半圆", + "mid": 485450109, + "typeid": "24", + "typename": "MAD·AMV", + "arcurl": "http://www.bilibili.com/video/av370000842", + "aid": 370000842, + "bvid": "BV1AZ4y1j7t6", + "title": "最近火爆全网的《少年》，你喜欢吗？", + "description": "BGM：少年——梦然\n花了好多心思的作品，求个三连呀φ(>ω<*)", + "arcrank": "0", + "pic": "//i0.hdslb.com/bfs/archive/7437b6f66856b0d87437afd8827939954716cb2f.jpg", + "play": 2257050, + "video_review": 16225, + "favorites": 95864, + "tag": "bilibili新星计划,AMV,MAD,新人向,论BGM的重要性,青春,少年,治愈向,催泪向,多素材", + "review": 3548, + "pubdate": 1585459066, + "senddate": 1585459067, + "duration": "1:37", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100409086 + }, + { + "type": "video", + "id": 837972700, + "author": "Da圣音乐", + "mid": 353230307, + "typeid": "130", + "typename": "音乐综合", + "arcurl": "http://www.bilibili.com/video/av837972700", + "aid": 837972700, + "bvid": "BV1Ug4y1z7oN", + "title": "终于找到日语版《少年》了！开口就是恋爱的味道，岛国也要被洗脑", + "description": "终于找到日语版《少年》了！开口就是恋爱的味道，岛国也要被洗脑", + "arcrank": "0", + "pic": "//i2.hdslb.com/bfs/archive/413b5417418c0e1107b3f79a284d20040b8bb4e9.jpg", + "play": 1390981, + "video_review": 2344, + "favorites": 11330, + "tag": "乐评盘点,梦然,少年,下山,日语,斋藤飞鸟,告白气球,花泽香菜,火影忍者,海贼王", + "review": 988, + "pubdate": 1588239130, + "senddate": 1588241127, + "duration": "3:12", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100407822 + }, + { + "type": "video", + "id": 285145715, + "author": "潮汕好男人", + "mid": 19071708, + "typeid": "22", + "typename": "鬼畜调教", + "arcurl": "http://www.bilibili.com/video/av285145715", + "aid": 285145715, + "bvid": "BV1ac411h7BC", + "title": "【全明星】少年", + "description": "我还是充钱那个少年，又大又圆的少年\nBGM：少年\n制作：MC传奇（潮汕好男人/永远的MG）\n\n黄绿合战Day.3 对阵作品：BV1qQ4y1K7Gs， 投票传送门：https://www.bilibili.com/blackboard/activity-yellowVSgreen5th.html", + "arcrank": "0", + "pic": "//i1.hdslb.com/bfs/archive/911faee003fc828c46497cbd58fab0e22c7554f8.jpg", + "play": 3689254, + "video_review": 38262, + "favorites": 115408, + "tag": "鬼畜调教,鬼畜,黄绿合战,少年,黄绿合战5th,全明星", + "review": 4560, + "pubdate": 1586404524, + "senddate": 1592816392, + "duration": "3:1", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100254286 + }, + { + "type": "video", + "id": 51475845, + "author": "吃你的馒头", + "mid": 25770774, + "typeid": "137", + "typename": "明星", + "arcurl": "http://www.bilibili.com/video/av51475845", + "aid": 51475845, + "bvid": "BV1K4411i7mw", + "title": "【日本少年混剪】氧气/心动瞬间/薄荷味的夏天要来了", + "description": "个人喜欢的霓虹国少年们混剪\n\n喜欢的少年会让我想起夏天，淡淡的薄荷味在校服衬衫晕开，笑容在空气里变成汽水，砰的一声打开砸向心脏。\n\nBGM：米津玄师/菅田将晖《灰色与青》\n\n道枝骏佑/新田真剑佑/菅田将晖\n坂口健太郎/古川雄辉/山崎贤人\n山田凉介/片寄凉太/贺来贤人\n龙星凉/佐藤健/吉沢亮\n柏原崇/锦户亮\n\n不按出场顺序（剪得昏天黑地完全记不住）\n\n禁二改转载出站，微博非本人发布皆为盗取视频，请随手举报或@吃你的馒头。\n\n原创作品不易，谢谢喜欢和理解。", + "arcrank": "0", + "pic": "//i2.hdslb.com/bfs/archive/93ae9d66eaf62161f1f12d0102b6c2d66ebe05a9.jpg", + "play": 1842547, + "video_review": 10738, + "favorites": 136384, + "tag": "明星,龙星凉,新田真剑佑,菅田将晖,古川雄辉,片寄凉太,柏原崇,山崎贤人,道枝骏佑,贺来贤人,山田凉介,锦户亮", + "review": 2385, + "pubdate": 1556992133, + "senddate": 1559716273, + "duration": "3:5", + "badgepay": false, + "hit_columns": [ + "title", + "description" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100239604 + }, + { + "type": "video", + "id": 967814999, + "author": "沙拉酱merry", + "mid": 492472, + "typeid": "31", + "typename": "翻唱", + "arcurl": "http://www.bilibili.com/video/av967814999", + "aid": 967814999, + "bvid": "BV1Hp4y1y7iQ", + "title": "真的不是原唱？！《少年》超A御姐音翻唱", + "description": "少年\n词/曲/原唱/Rap：梦然\n和声编写：海青/梦然\n和声演唱：海青/梦然\n翻唱：沙拉酱merry\n后期：小敏\n这首歌真好听！\nPs：由于这首歌的难度和换气问题，音频和视频是分开录的所以会有口型差异，敬请谅解！！！大家听歌愉快~", + "arcrank": "0", + "pic": "//i0.hdslb.com/bfs/archive/565e8cdc98dab13dfa547cb13744410964f2fc00.jpg", + "play": 959598, + "video_review": 2447, + "favorites": 15166, + "tag": "被才华封印的颜值,少年,翻唱,女声,沙拉酱merry,御姐音", + "review": 1371, + "pubdate": 1587114006, + "senddate": 1587114030, + "duration": "7:58", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100235329 + }, + { + "type": "video", + "id": 455021866, + "author": "鲨然鲨然", + "mid": 435476320, + "typeid": "126", + "typename": "人力VOCALOID", + "arcurl": "http://www.bilibili.com/video/av455021866", + "aid": 455021866, + "bvid": "BV195411673y", + "title": "【川普】我还是曾经那个少年", + "description": "鬼畜娱乐，请勿当真哦\n希望大家能开怀一笑\n笑了的话别忘了点赞哦", + "arcrank": "0", + "pic": "//i0.hdslb.com/bfs/archive/7cee31977deb39f297d2d2598e736d26ed337568.jpg", + "play": 3845319, + "video_review": 34660, + "favorites": 74705, + "tag": "黄绿合战5th-黄队应援,鬼畜调教,人力VOCALOID,自制,UTAU,川普,搞笑,少年,恶搞,青春", + "review": 4469, + "pubdate": 1585651085, + "senddate": 1586266006, + "duration": "2:56", + "badgepay": false, + "hit_columns": [ + "title", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100163091 + }, + { + "type": "video", + "id": 753055295, + "author": "大门E", + "mid": 735734, + "typeid": "31", + "typename": "翻唱", + "arcurl": "http://www.bilibili.com/video/av753055295", + "aid": 753055295, + "bvid": "BV1xk4y1k7aw", + "title": "【完整版日语版《少年》本尊来了】竟是国人元老唱见~", + "description": "词：lolo2513&梦然\n曲：梦然\n编曲：张亮\n混音：顾潇予\nPV：大门E\n之前唱了一个片段不料被许多人误以为《少年》原版是日本歌曲改编。因为没有版权一直没full，如今终于得到梦然老师（版权方）的认可及改编授权，终于出来了，再次感谢~！以我的key重新编曲，好哥们儿@lolo2513 老师的完整版日文填词，满满的少年jump既视感，唱的时候满脑子鸣人路飞，作为一个十五年的国人老唱见能被大家认可一首ACG歌曲简直泪流满面，希望大家能够喜欢~", + "arcrank": "0", + "pic": "//i1.hdslb.com/bfs/archive/363ece7b0fd61d1eb48a4bc3c2e804446b46ca1d.jpg", + "play": 676181, + "video_review": 1209, + "favorites": 31147, + "tag": "bilibili新星计划,少年,日语歌,翻唱", + "review": 1964, + "pubdate": 1588932007, + "senddate": 1588957659, + "duration": "4:1", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100152701 + }, + { + "type": "video", + "id": 328601322, + "author": "萌宠教主", + "mid": 23976014, + "typeid": "24", + "typename": "MAD·AMV", + "arcurl": "http://www.bilibili.com/video/av328601322", + "aid": 328601322, + "bvid": "BV1EA411i7MD", + "title": "用三十部动漫唱一首《少年》——你长大了，你还在追番吗?", + "description": "BGM：少年\n【剪辑，填词】萌宠教主\n【演唱】浅若_natsu", + "arcrank": "0", + "pic": "//i0.hdslb.com/bfs/archive/eb7c1be356fd3bc6a947bb6398b6f02fc961bec2.jpg", + "play": 381018, + "video_review": 2881, + "favorites": 28530, + "tag": "少年,AMV,多素材,MAD,综漫,混剪,梦然,催泪", + "review": 922, + "pubdate": 1592020805, + "senddate": 1592020836, + "duration": "4:5", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100129139 + }, + { + "type": "video", + "id": 838737756, + "author": "bili_148834382", + "mid": 148834382, + "typeid": "138", + "typename": "搞笑", + "arcurl": "http://www.bilibili.com/video/av838737756", + "aid": 838737756, + "bvid": "BV1Ug4y1v7mU", + "title": "大爷：我还是从前那个少年，没有一丝丝改变!", + "description": "大爷：我还是从前那个少年，没有一丝丝改变!", + "arcrank": "0", + "pic": "//i2.hdslb.com/bfs/archive/912cb238879558119d2f129438d7c71bb4372f9e.jpg", + "play": 7052, + "video_review": 18, + "favorites": 17, + "tag": "逗比,挑战,卧槽,沙雕,搞笑,大爷,厉害了,不一样呀,秀", + "review": 8, + "pubdate": 1593489906, + "senddate": 1593489906, + "duration": "1:34", + "badgepay": false, + "hit_columns": [ + "title", + "description" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100123108 + }, + { + "type": "video", + "id": 541162396, + "author": "鬼兄奇谈", + "mid": 94641579, + "typeid": "124", + "typename": "社科人文", + "arcurl": "http://www.bilibili.com/video/av541162396", + "aid": 541162396, + "bvid": "BV1Bi4y1G7mo", + "title": "少年黑帮“新龙会”覆灭记！史上最“中二”的黑社会，作案后竟留下错别字？", + "description": "少年黑帮“新龙会”覆灭记！史上最“中二”的黑社会，作案后竟留下错别字？\n视频内容及素材均来源于网络", + "arcrank": "0", + "pic": "//i2.hdslb.com/bfs/archive/4c0c8d8f720119e3087b6b02025c3d957d642781.jpg", + "play": 150747, + "video_review": 627, + "favorites": 487, + "tag": "犯罪,案件,奇闻,全能打卡挑战,学生,法制,黑社会,中二,违法", + "review": 438, + "pubdate": 1593596709, + "senddate": 1593596710, + "duration": "8:42", + "badgepay": false, + "hit_columns": [ + "title", + "description" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100120066 + }, + { + "type": "video", + "id": 413715309, + "author": "wkkm13", + "mid": 4056950, + "typeid": "76", + "typename": "美食圈", + "arcurl": "http://www.bilibili.com/video/av413715309", + "aid": 413715309, + "bvid": "BV1gV41167WS", + "title": "梦开始的地方，一年前那个不会剪辑的少年阿强。", + "description": "转自强哥第一个视频，那时候他还叫“浮华d假象”。\n梦开始的地方，那个不会剪辑的少年。", + "arcrank": "0", + "pic": "//i0.hdslb.com/bfs/archive/73772867e6a4ebaf66a12c73f1bc0d7a1f0fa085.jpg", + "play": 149332, + "video_review": 332, + "favorites": 86, + "tag": "cram阿强,泪目,美食,吃播,梦想,剪辑", + "review": 437, + "pubdate": 1593604848, + "senddate": 1593604848, + "duration": "5:31", + "badgepay": false, + "hit_columns": [ + "title", + "description" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100102196 + }, + { + "type": "video", + "id": 838507935, + "author": "木子山上起酥酥", + "mid": 185924591, + "typeid": "75", + "typename": "动物圈", + "arcurl": "http://www.bilibili.com/video/av838507935", + "aid": 838507935, + "bvid": "BV1Jg4y1q77h", + "title": "少年人，这是修行。", + "description": "微博", + "arcrank": "0", + "pic": "//i1.hdslb.com/bfs/archive/8eae881830a5fc2be1434781e086f7191082cec8.jpg", + "play": 120068, + "video_review": 43, + "favorites": 312, + "tag": "逗比,正能量,水豚,动物", + "review": 155, + "pubdate": 1592366769, + "senddate": 1592366769, + "duration": "0:15", + "badgepay": false, + "hit_columns": [ + "title" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100101593 + }, + { + "type": "video", + "id": 47749359, + "author": "Da圣音乐", + "mid": 353230307, + "typeid": "130", + "typename": "音乐综合", + "arcurl": "http://www.bilibili.com/video/av47749359", + "aid": 47749359, + "bvid": "BV12b411W7nF", + "title": "16岁中国少年韩国综艺上怒怼：老子来自中国！现场一片哗然", + "description": "16岁中国少年韩国综艺上怒怼：老子来自中国！现场一片哗然", + "arcrank": "0", + "pic": "//i1.hdslb.com/bfs/archive/171d9b27a0b9823b71894008117501014dd561ba.jpg", + "play": 5042589, + "video_review": 3949, + "favorites": 26065, + "tag": "说唱,韩国,中国,音乐选集,Rap,瞧不起,DISS,迪亚克,D.ark,综艺节目", + "review": 2793, + "pubdate": 1553926233, + "senddate": 1553926233, + "duration": "2:38", + "badgepay": false, + "hit_columns": [ + "title", + "description" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100101064 + }, + { + "type": "video", + "id": 82363754, + "author": "在下甘柒辣", + "mid": 374835894, + "typeid": "24", + "typename": "MAD·AMV", + "arcurl": "http://www.bilibili.com/video/av82363754", + "aid": 82363754, + "bvid": "BV1qJ411V7QH", + "title": "我已不再是少年，但你们终究活在我心里", + "description": "国动会越来越好的，它由我们一同注目它的成长。\nBGM: start\n可否给个币，给这个肝疼的up点鼓励(￣y▽￣)~*", + "arcrank": "0", + "pic": "//i2.hdslb.com/bfs/archive/2c7afbc835dbce9f554eb1b21b583ef6bed34cce.jpg", + "play": 1588667, + "video_review": 6782, + "favorites": 37909, + "tag": "国产动画,国漫良心,国漫,国漫王者归来,星游记,镇魂街,灵笼,刺客伍六七,大圣归来,哪吒", + "review": 1190, + "pubdate": 1578320753, + "senddate": 1582999612, + "duration": "3:44", + "badgepay": false, + "hit_columns": [ + "title" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100099970 + }, + { + "type": "video", + "id": 413742409, + "author": "音乐Fans小琼", + "mid": 342943435, + "typeid": "130", + "typename": "音乐综合", + "arcurl": "http://www.bilibili.com/video/av413742409", + "aid": 413742409, + "bvid": "BV1bV41167Un", + "title": "《少年》霸占7周热歌第一，如今终于被新的神曲打破！网友：听吐了！", + "description": "bgm 纸砚zyan《画皮》\n《惊雷》MC六道\n《素颜》许嵩\n《麻雀》李荣浩\n《点歌的人》海来阿木\n《桥边姑娘》海伦 \n《旧梦一场》阿悠悠\n《世界这么大还是遇见你》程响（翻唱）\n《后来遇见他》胡66\n《处处吻》杨千嬅\n《少年》梦然", + "arcrank": "0", + "pic": "//i2.hdslb.com/bfs/archive/f004565df82a9ac3a8a168b4c12e244861f1d812.jpg", + "play": 12363, + "video_review": 137, + "favorites": 100, + "tag": "乐评盘点,全能打卡挑战,翻唱,许嵩,杨千嬅,李荣浩,喊麦,民谣,热歌,神曲", + "review": 71, + "pubdate": 1593523679, + "senddate": 1593576757, + "duration": "3:37", + "badgepay": false, + "hit_columns": [ + "title", + "description" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100097483 + }, + { + "type": "video", + "id": 625380628, + "author": "涩廊", + "mid": 178366933, + "typeid": "137", + "typename": "明星", + "arcurl": "http://www.bilibili.com/video/av625380628", + "aid": 625380628, + "bvid": "BV1Xt4y127bX", + "title": "这TM才叫日系美少年！", + "description": "道枝骏佑，02年霓虹国弟弟！杰尼斯美少年！没长残的童星代表！身高现在180+了！绰号米七（谐音）\n出演过电视剧《成为母亲》《我的裙子去哪了》\n\n米七是一个超级帅气可爱的男孩子！一直都在努力提升自己，请敬请期待他未来的作品！\n米七米七！未来可期！\n跪求三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连三连", + "arcrank": "0", + "pic": "//i2.hdslb.com/bfs/archive/9d727949eed2d82eb0561d08cbb3e28ac6603532.jpg", + "play": 768179, + "video_review": 1595, + "favorites": 29494, + "tag": "全能打卡挑战,杰尼斯,美少年,道枝骏佑,日系,米七", + "review": 1545, + "pubdate": 1588381204, + "senddate": 1590253109, + "duration": "1:22", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 100094816 + } + ], + "show_column": 0 + } +} +``` + +1：是 | +| rec_tags | null | - | **作用尚不明确** | +| new_rec_tags | array | 空 | **作用尚不明确** | +| rank_score | num | 结果排序量化值 | | + +`视频条目`中的`hit_columns`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ------------------------------------------------------------ | +| 0 | str | 匹配类型1 | title：标题匹配
description：简介匹配
author：UP主昵称匹配
tag：视频TAG匹配 | +| n | str | 匹配类型（n+1） | 项数为同时匹配到的类型数 | +| …… | str | …… | …… | + +**示例：** + +
+
+
+## 对象类型2-结果为番剧&影视
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------------- | ------------------------------- | ---------------------------- | ------------------------------------------------------------ |
+| type | str | 结果类型 | media_bangumi：番剧查看响应示例：
+ +```json +{ + "type": "video", + "id": 78977417, + "author": "MitchieM", + "mid": 5669526, + "typeid": "30", + "typename": "VOCALOID·UTAU", + "arcurl": "http://www.bilibili.com/video/av78977417", + "aid": 78977417, + "bvid": "BV1KJ411C7Un", + "title": "【Mitchie M】初音未来《买买买》【2020拜年祭单品】", + "description": "bilibili拜年祭のために、ダンスミュージックと中国の伝統楽器を組み合わせた曲を作りました。歌詞に「买买买」を使ったユニークな曲が出来上がったので、最高のクオリティーのMVと共に楽しんでもらえたら嬉しいです！\n为哔哩哔哩拜年祭制作了一首电子舞曲与中国传统乐器相结合的音乐，歌词是描写【买买买】的独特作品，和最棒的PV一起享受吧!\n\n▶︎ 舞蹈视频 [BV1pA411i7J6]", + "arcrank": "0", + "pic": "//i1.hdslb.com/bfs/archive/f0403bbd1ff3bad1df79aaa159d9e1cfb52c92de.jpg", + "play": 2915520, + "video_review": 14572, + "favorites": 114102, + "tag": "2020拜年祭单品,买买买,初音未来", + "review": 6124, + "pubdate": 1579877678, + "senddate": 1593099008, + "duration": "4:2", + "badgepay": false, + "hit_columns": [ + "title", + "description", + "tag" + ], + "view_type": "", + "is_pay": 0, + "is_union_video": 0, + "rec_tags": null, + "new_rec_tags": [], + "rank_score": 109020056 +} +``` + +media_ft：影视 | +| media_id | num | 剧集mdid | | +| season_id | num | 剧集ssid | | +| title | str | 剧集标题 | 关键字用xml标签``标注 | +| org_title | str | 剧集原名 | 关键字用xml标签``标注
可为空 | +| cover | str | 剧集封面url | | +| media_type | num | 剧集类型 | 1：番剧
2：电影
3：纪录片
4：国创
5：电视剧
7：综艺 | +| areas | str | 地区 | | +| styles | str | 风格 | | +| cv | str | 声优 | | +| staff | str | 制作组 | | +| play_state | num | 0 | **作用尚不明确** | +| goto_url | str | 剧集重定向url | | +| desc | str | 简介 | | +| corner | num | 角标有无 | 2：无
13：有 | +| pubtime | num | 开播时间 | 时间戳 | +| media_mode | num | 2 | **作用尚不明确** | +| is_avid | bool | false | **作用尚不明确** | +| fix_pubtime_str | str | 开播时间重写信息 | 优先级高于`pubtime`
可为空 | +| media_score | 有效时：obj
无效时：null | 评分信息 | | +| hit_columns | 有效时：array
无效时：null | 关键字匹配类型 | | +| all_net_name | str | 空 | **作用尚不明确** | +| all_net_icon | str | 空 | **作用尚不明确** | +| all_net_url | str | 空 | **作用尚不明确** | +| angle_title | str | 角标内容 | | +| angle_color | num | 角标颜色 | 0：红色
2：橙色 | +| display_info | array | 剧集标志信息 | | +| hit_epids | str | 关键字匹配分集标题的分集epid | 多个用`,`分隔 | +| pgc_season_id | num | 剧集ssid | | +| season_type | num | 剧集类型 | 1：番剧
2：电影
3：纪录片
4：国创
5：电视剧
7：综艺 | +| season_type_name | str | 剧集类型文字 | | +| selection_style | str | 分集选择按钮风格 | horizontal：横排式
grid：按钮式 | +| ep_size | num | 结果匹配的分集数 | | +| url | str | 剧集重定向url | | +| button_text | str | 观看按钮文字 | | +| is_follow | num | 是否追番 | 需要登录(SESSDATA)
未登录则恒为0
0：否
1：是 | +| is_selection | num | 1 | **作用尚不明确** | +| eps | array | 结果匹配的分集信息 | | +| badges | array | 剧集标志信息 | | + +`番剧条目`中的`media_score`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | ------------ | ---- | +| user_count | num | 总计评分人数 | | +| score | num | 评分 | | + +`番剧条目`中的`hit_columns`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | -------------------------------------- | +| 0 | str | 匹配类型1 | title：标题匹配
org_title：原标题 | +| n | str | 匹配类型（n+1） | 项数为同时匹配到的类型数 | +| …… | str | …… | …… | + +`番剧条目`中的`display_info`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ---- | +| 0 | obj | 剧集标志信息 | | + +`display_info`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------------ | ---- | ------------ | ------ | +| bg_color_night | str | 夜间背景颜色 | 颜色码 | +| text | str | 剧集标志 | 颜色码 | +| border_color | str | 背景颜色 | 颜色码 | +| bg_style | num | 1 | | +| text_color | str | 文字颜色 | 颜色码 | +| bg_color | str | 背景颜色 | 颜色码 | +| text_color_night | str | 夜间文字颜色 | 颜色码 | +| border_color_night | str | 夜间背景颜色 | 颜色码 | + +`番剧条目`中的`eps`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ------------------------ | +| 0 | obj | 分集信息1 | | +| n | obj | 分集信息（n+1） | 项数为同时匹配到的分集数 | +| …… | obj | …… | …… | + +`eps`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ----- | ------------- | ---- | +| id | num | 分集epid | | +| cover | str | 分集封面url | | +| title | str | 完整标题 | | +| url | str | 分集重定向url | | +| release_date | str | 空 | | +| badges | array | 分集标志 | | +| index_title | str | 短标题 | | +| long_title | str | 单集标题 | | + +`番剧条目`中的`badges`数组（同`eps`数组中的对象中的`badges`数组）： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ---- | +| 0 | obj | 剧集标志信息 | | + +`badges`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------------ | ---- | ------------ | ------ | +| text | str | 剧集标志 | 颜色码 | +| text_color | str | 文字颜色 | 颜色码 | +| text_color_night | str | 夜间文字颜色 | 颜色码 | +| bg_color | str | 背景颜色 | 颜色码 | +| bg_color_night | str | 夜间背景颜色 | 颜色码 | +| border_color | str | 空 | | +| border_color_night | str | 空 | | +| bg_style | num | 1 | | + +**示例：** + +
+
+
+## 对象类型3-结果为直播间
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ----- | -------------- | ----------------------------------------- |
+| type | str | 结果类型 | 固定为live_room |
+| rank_offset | num | 搜索结果排名值 | |
+| uid | num | 主播mid | |
+| tas | str | 直播间TAG | 多个用`,`分隔 |
+| hit_columns | array | 关键字匹配类型 | |
+| live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS |
+| cate_name | str | 子分区名 | |
+| live_status | num | 1 | |
+| uname | str | 主播昵称 | |
+| uface | str | 主播头像url | |
+| user_cover | str | 直播间封面url | |
+| short_id | num | 0 | **作用尚不明确** |
+| area | num | 1 | **作用尚不明确** |
+| title | str | 直播间标题 | 关键字用xml标签``标注 |
+| cover | str | 关键帧截图url | |
+| online | num | 在线人数 | |
+| rank_index | num | 0 | **作用尚不明确** |
+| rank_score | num | 结果排序量化值 | |
+| roomid | num | 直播间id | |
+| attentions | num | 主播粉丝数 | |
+
+`直播间条目`中的`hit_columns`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ------------------------------------------------------------ |
+| 0 | str | 匹配类型1 | title：直播间标题匹配查看响应示例：
+ +```json +{ + "media_id": 28224080, + "season_id": 29310, + "type": "media_bangumi", + "title": "异度侵入 ID:INVADED", + "org_title": "イド：インヴェイデッド", + "cover": "//i0.hdslb.com/bfs/bangumi/image/9bf9e66968f85b33ec3769a16c86b36dc984abbc.png", + "media_type": 1, + "areas": "日本", + "styles": "原创/科幻/推理", + "cv": "酒井户：津田健次郎\n百贵：细谷佳正\n富久田：竹内良太\n本堂町：M・A・O\n东乡：布里德卡特·塞拉·惠美\n早濑浦：村治学\n白岳：近藤隆\n羽二重：岩濑周平\n若鹿：榎木淳弥\n国府：加藤涉\n西村：落合福嗣\n松冈：西凛太朗 ", + "staff": "监督：青木英\n脚本：舞城王太郎\n角色原案：小玉有起\n角色设计：碇谷敦\n美术：曽野由大\n作画监督：又贺大介\n副监督：久保田雄大\n色彩设计：千叶絵美\n动画制作：NAZ", + "play_state": 0, + "goto_url": "https://www.bilibili.com/bangumi/play/ss29310/", + "desc": "本片讲述利用能检测出人们杀意的装置以及利用思想粒子做出的“井”，来探知事件真相的科幻故事。", + "corner": 13, + "pubtime": 1578240000, + "media_mode": 2, + "is_avid": false, + "fix_pubtime_str": "", + "media_score": { + "user_count": 275391, + "score": 9.8 + }, + "hit_columns": [ + "title" + ], + "all_net_name": "", + "all_net_icon": "", + "all_net_url": "", + "angle_title": "会员专享", + "angle_color": 0, + "display_info": [ + { + "bg_color_night": "#BB5B76", + "text": "会员专享", + "border_color": "#FB7299", + "bg_style": 1, + "text_color": "#FFFFFF", + "bg_color": "#FB7299", + "text_color_night": "#E5E5E5", + "border_color_night": "#BB5B76" + } + ], + "hit_epids": "", + "pgc_season_id": 29310, + "season_type": 1, + "season_type_name": "番剧", + "selection_style": "grid", + "ep_size": 13, + "url": "https://www.bilibili.com/bangumi/play/ss29310", + "button_text": "立即观看", + "is_follow": 1, + "is_selection": 1, + "eps": [ + { + "id": 307446, + "cover": "http://i0.hdslb.com/bfs/archive/4a1895e5b675209b6948dc321c3cc4991a6262bc.jpg", + "title": "1", + "url": "https://www.bilibili.com/bangumi/play/ep307446", + "release_date": "", + "badges": [], + "index_title": "1", + "long_title": "JIGSAWED 碎片世界" + }, + { + "id": 307447, + "cover": "http://i0.hdslb.com/bfs/archive/c66175203fdb6f54a9fb3accd793da0341b3140a.jpg", + "title": "2", + "url": "https://www.bilibili.com/bangumi/play/ep307447", + "release_date": "", + "badges": [ + { + "text": "会员", + "text_color": "#FFFFFF", + "text_color_night": "#E5E5E5", + "bg_color": "#FB7299", + "bg_color_night": "#BB5B76", + "border_color": "", + "border_color_night": "", + "bg_style": 1 + } + ], + "index_title": "2", + "long_title": "JIGSAWED Ⅱ 碎片世界" + }, + ………… + ], + "badges": [ + { + "text": "会员专享", + "text_color": "#FFFFFF", + "text_color_night": "#E5E5E5", + "bg_color": "#FB7299", + "bg_color_night": "#BB5B76", + "border_color": "", + "border_color_night": "", + "bg_style": 1 + } + ] +}, +``` + +cate_name：子分区名匹配
uname：主播昵称匹配 | +| n | str | 匹配类型（n+1） | 项数为同时匹配到的类型数 | +| …… | str | …… | …… | + +**示例：** + +
+
+
+## 对象类型4-结果为主播
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ----- | -------------- | ------------------------------------------------------ |
+| type | str | 结果类型 | 固定为live_user |
+| rank_offset | num | 搜索结果排名值 | |
+| uid | num | 主播mid | |
+| tas | str | 直播间TAG | 多个用`,`分隔 |
+| live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS查看响应示例：
+ +```json +{ + "rank_offset": 1, + "uid": 682508, + "tags": "minecraft,声控,我的世界,虚拟主播,助眠", + "hit_columns": [ + "title", + "cate_name" + ], + "live_time": "2020-07-03 19:08:46", + "cate_name": "我的世界", + "live_status": 1, + "uname": "超心塞的十六", + "uface": "//i0.hdslb.com/bfs/face/dc33ad47b5e299c08bea9cfe565373213012599c.jpg", + "user_cover": "//i0.hdslb.com/bfs/live/new_room_cover/cbc7b1d0ba181df2c714c2e45ab00937129d3c5c.jpg", + "short_id": 148, + "area": 1, + "type": "live_room", + "title": "MC 1.16 极限服", + "cover": "//i0.hdslb.com/bfs/live/keyframe07031915000000010313u3z18a.jpg", + "online": 34702, + "rank_index": 0, + "rank_score": 34702, + "roomid": 10313, + "attentions": 317864 +} +``` + +如未开播为0000-00-00 00:00:00 | +| hit_columns | array | 关键字匹配类型 | | +| live_status | num | 是否开播 | 0：未开播
1：已开播 | +| area | num | 1 | **作用尚不明确** | +| is_live | bool | 是否开播 | false：未开播
true：已开播 | +| uname | str | 主播昵称 | 关键字用xml标签``标注 | +| uface | str | 主播头像url | | +| rank_index | num | 0 | **作用尚不明确** | +| rank_score | num | 结果排序量化值 | | +| attentions | num | 主播粉丝数 | | + +`主播条目`中的`hit_columns`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ------------------------ | +| 0 | str | 匹配类型1 | uname：主播昵称匹配 | +| n | str | 匹配类型（n+1） | 项数为同时匹配到的类型数 | +| …… | str | …… | …… | + +**示例：** + +
+
+
+## 对象类型5-结果为专栏
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------- | ----- | -------------- | ---------------- |
+| type | str | 结果类型 | 固定为article |
+| rank_offset | num | 搜索结果排名值 | |
+| pub_time | num | 投稿时间 | 时间戳 |
+| like | num | 获赞数 | |
+| title | str | 标题 | |
+| mid | num | UP主mid | |
+| image_urls | array | 封面图组 | |
+| template_id | num | ？？？ | **作用尚不明确** |
+| category_id | num | 专栏分区 | |
+| view | num | 阅读数 | |
+| reply | num | 评论数 | |
+| rank_index | num | 0 | **作用尚不明确** |
+| desc | str | 文章预览 | |
+| rank_score | num | 结果排序量化值 | |
+| id | num | 专栏cvid | |
+| category_name | str | 子分区名 | |
+
+`专栏条目`中的`covers`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ---- |
+| 0 | str | 封面图片1 | |
+| n | str | 封面图片（n+1） | |
+| …… | str | …… | |
+
+**示例：**
+
+查看响应示例：
+ +```json +{ + "rank_offset": 1, + "uid": 322892, + "tags": "鬼畜,游戏,瞎扯淡,轰炸挂", + "type": "live_user", + "live_time": "2020-07-03 17:57:30", + "hit_columns": [ + "uname" + ], + "live_status": 1, + "area": 1, + "is_live": true, + "uname": "痒局长", + "uface": "//i2.hdslb.com/bfs/face/bcdf640faa16ebaacea1d4c930baabaec9087a80.jpg", + "rank_index": 0, + "rank_score": 2620790, + "roomid": 5441, + "attentions": 2570790 +} +``` + +
+
+
+## 对象类型6-结果为话题
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ----- | ----------------- | ---------------- |
+| type | str | 结果类型 | 固定为topic |
+| description | str | 简介 | |
+| pubdate | nm | 发布时间 | 时间戳 |
+| title | str | 标题 | |
+| favourite | num | 0 | **作用尚不明确** |
+| hit_columns | array | 关键字匹配类型 | |
+| review | num | 0 | **作用尚不明确** |
+| rank_offset | num | 搜索结果排名值 | |
+| cover | str | 话题封面url | |
+| update | num | 上传时间 | 时间戳 |
+| mid | nm | 0 | **作用尚不明确** |
+| click | num | ？？？ | **作用尚不明确** |
+| tp_type | num | ？？？ | **作用尚不明确** |
+| keyword | str | 空 | **作用尚不明确** |
+| tp_id | num | 话题tp | |
+| rank_index | num | 0 | **作用尚不明确** |
+| author | str | UP主昵称 | |
+| arcurl | str | 话题页面重定向url | |
+| rank_score | num | 结果排序量化值 | |
+
+`话题条目`中的`hit_columns`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ------------------------ |
+| 0 | str | 匹配类型1 | title：话题标题匹配 |
+| n | str | 匹配类型（n+1） | 项数为同时匹配到的类型数 |
+| …… | str | …… | …… |
+
+**示例：**
+
+查看响应示例：
+ +```json +{ + "pub_time": 1582123245, + "like": 113, + "title": "【洛水闲谈】《普通DISCO》神话达成后的个人感想", + "rank_offset": 1, + "mid": 295535204, + "image_urls": [ + "//i0.hdslb.com/bfs/article/0c2e7e3cc14f7e097482688600be713a9e9a7029.png" + ], + "template_id": 4, + "category_id": 4, + "view": 843, + "reply": 58, + "rank_index": 0, + "desc": "今天，2020年2月19日，随着bilibili弹幕网上《普通DISCO》的播放量突破1000W，中文VOCALOID的第一首神话级歌曲诞生了。笔者昨夜盯着《普通DISCO》的播放量的增长速率熬到很晚，今早又起了个大早盯着那最后一万的播放量差距，直到播放量突破1000W才放松紧绷的神经，敲打键盘时肢体困倦神疲乏力，故长话短说，若有表达不妥之处还望各位海涵。ilem教主，其拥有近二十首百万传说曲，占bilibili弹幕网中文VOCALOID百万传说曲的三分之一，中文VOCALOID第一首传说曲与第", + "rank_score": 19, + "type": "article", + "id": 4743576, + "category_name": "动漫杂谈" +} +``` + +
+
+
+## 对象类型7-结果为用户
+
+| 字段 | 类型 | 内容 | 备注 |
+| --------------- | ----- | -------------- | ----------------------------- |
+| type | str | 结果类型 | 固定为bili_user |
+| mid | num | 用户mid | |
+| uname | str | 用户昵称 | |
+| usign | str | 用户签名 | |
+| fans | num | 用户粉丝数 | |
+| videos | num | 用户稿件数 | |
+| upic | str | 用户头像url | |
+| verify_info | str | 空 | **作用尚不明确** |
+| level | num | 用户等级 | |
+| gender | num | 用户性别 | 1：男查看响应示例：
+ +```json +{ + "description": "「Bad Apple」的各式各样的PV有很多很多，小编在这里给大家推荐一些比较特别且高人气的特别PV......", + "pubdate": 1479380676, + "title": "「Bad Apple」 的N种特别PV", + "favourite": 0, + "hit_columns": [ + "title" + ], + "review": 0, + "rank_offset": 1, + "cover": "//i0.hdslb.com/bfs/active/3005a94d446db3873d97b483323156b491d850ac.jpg", + "update": 31507200, + "mid": 0, + "click": 211843, + "tp_type": 0, + "keyword": "", + "tp_id": 2215, + "rank_index": 0, + "author": "Nuuu", + "type": "topic", + "arcurl": "http://www.bilibili.com/topic/50.html", + "rank_score": 1851888 +} +``` + +2：女
3：私密 | +| is_upuser | num | 是否为UP主 | 0：否
1：是 | +| is_live | num | 是否正在直播 | 0：否
1：是 | +| room_id | num | 用户直播间id | | +| res | array | 用户投稿内容 | | +| official_verify | obj | 用户认证信息 | | +| hit_columns | array | 关键字匹配类型 | | + +`用户条目`中的`res`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------------- | ------------------------- | +| 0 | obj | 用户投稿视频1 | | +| n | obj | 用户投稿视频（n+1） | 项数为用户投稿的3个视频数 | +| …… | obj | …… | …… | + +`res`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------------- | ---- | ----------------- | ---------------- | +| aid | num | 稿件avid | | +| bvid | str | 稿件bvid | | +| title | str | 视频标题 | | +| pubdate | num | 视频投稿时间 | 时间戳 | +| arcurl | str | 视频页面重定向url | | +| pic | str | 视频封面图片url | | +| play | str | 播放量 | | +| dm | str | 弹幕量 | | +| coin | num | 投币数 | | +| fav | num | 收藏数 | | +| desc | str | 视频简介 | | +| duration | str | 视频时长 | MM:SS | +| is_pay | num | 0 | **作用尚不明确** | +| is_union_video | num | 是否为合作视频 | 0：否
1：是 | + +`用户条目`中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ----------------------------------------- | +| type | num | 是否认证 | 127：无
0：个人认证
1：组织认证 | +| desc | str | 认证名称 | | + +`用户条目`中的`hit_columns`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | ------------------------ | +| 0 | str | 匹配类型1 | uname：用户昵称匹配 | +| n | str | 匹配类型（n+1） | 项数为同时匹配到的类型数 | +| …… | str | …… | …… | + +**示例：** + +
+
+
+## 对象类型8-结果为相簿
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ----- | -------------- | ---------------- |
+| type | str | 结果类型 | 固定为photo |
+| count | num | 图片数 | |
+| like | num | 收藏数 | |
+| title | str | 相簿标题 | |
+| hit_columns | array | 关键字匹配类型 | |
+| rank_offset | num | 搜索结果排名值 | |
+| cover | str | 相簿封面url | |
+| mid | num | UP主mid | |
+| uname | str | UP主昵称 | |
+| rank_index | num | 0 | **作用尚不明确** |
+| view | num | 观看次数 | |
+| id | num | 相簿id | |
+| rank_score | num | 结果排序量化值 | |
+
+`相簿条目`中的`hit_columns`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | ------------------------------------------------------------ |
+| 0 | str | 匹配类型1 | title：相簿标贴匹配查看响应示例：
+ +```json +{ + "type": "bili_user", + "mid": 208259, + "uname": "陈睿", + "usign": "喜欢的话就坚持吧", + "fans": 1561640, + "videos": 5, + "upic": "//i1.hdslb.com/bfs/app/8920e6741fc2808cce5b81bc27abdbda291655d3.png", + "verify_info": "", + "level": 6, + "gender": 1, + "is_upuser": 1, + "is_live": 0, + "room_id": 3394945, + "res": [ + { + "aid": 883660923, + "bvid": "BV1SK4y1477d", + "title": "BILIBILI 11周年演讲", + "pubdate": 1593176427, + "arcurl": "http://www.bilibili.com/video/av883660923", + "pic": "//i0.hdslb.com/bfs/archive/b28021df9c67ee2821cb9c1142b9d5e594e3b951.jpg", + "play": "6144081", + "dm": 185789, + "coin": 167803, + "fav": 147421, + "desc": "BILIBILI 11周年演讲，邀请数位嘉宾分享他们与B站的故事。\n陈睿《bilibili 11周年主题演讲》\n机智的党妹 《在B站，表达自我》\n腾格尔《在B站，做全新的腾格尔》\n周深《在B站，做一个歌手》《起风了》\n罗翔《在B站，授业与解惑》\nCarly李旎《在B站，一起成长》\nBILIBILI 11周年特映片《喜相逢》", + "duration": "217:7", + "is_pay": 0, + "is_union_video": 1 + }, + { + "aid": 838688095, + "bvid": "BV1Wg4y1v77h", + "title": "我们的五年——B站五年员工纪念视频 2020版", + "pubdate": 1593004830, + "arcurl": "http://www.bilibili.com/video/av838688095", + "pic": "//i1.hdslb.com/bfs/archive/701da662dfe00fb180eb4a47f1c38403838570a7.jpg", + "play": "957960", + "dm": 10830, + "coin": 44030, + "fav": 23108, + "desc": "每年626前夕，我们都会给本年度满五年工龄的员工颁发金LOGO（金质的小电视胸章），感谢他们对公司的陪伴和付出。“五年守护，感恩有你”", + "duration": "4:51", + "is_pay": 0, + "is_union_video": 0 + }, + { + "aid": 327892668, + "bvid": "BV1fA411b7zo", + "title": "【推荐一本喜欢的书】上帝掷骰子吗？", + "pubdate": 1587632267, + "arcurl": "http://www.bilibili.com/video/av327892668", + "pic": "//i0.hdslb.com/bfs/archive/c3ec25e2e4425303d7f4915692e3a9f0ec027669.jpg", + "play": "2131624", + "dm": 13570, + "coin": 37432, + "fav": 35498, + "desc": "#推荐一本喜欢的书# 423世界读书日，推荐我看过的最好看的量子物理科普书籍《上帝掷骰子吗》#读书等身#\n欢迎参与B站读书日活动：https://www.bilibili.com/blackboard/activity-gNeFPygv0.html 你每投一个读书视频，B站都会为你捐出一本书。", + "duration": "4:46", + "is_pay": 0, + "is_union_video": 0 + } + ], + "official_verify": { + "type": 0, + "desc": "bilibili董事长兼CEO" + }, + "hit_columns": [ + "uname" + ] +} +``` + +description：相簿简介匹配
source_tag：相簿TAG匹配 | +| n | str | 匹配类型（n+1） | 项数为同时匹配到的类型数 | +| …… | str | …… | …… | + +**示例：** + +
+
\ No newline at end of file
diff --git a/docs/search/suggest.md b/docs/search/suggest.md
new file mode 100644
index 0000000000..441054f73f
--- /dev/null
+++ b/docs/search/suggest.md
@@ -0,0 +1,185 @@
+# 搜索建议
+
+- [获取搜索建议关键词（web端）](#获取搜索建议关键词web端)
+
+---
+
+## 获取搜索建议关键词（web端）
+
+> https://s.search.bilibili.com/main/suggest
+
+*请求方式：GET*
+
+搜索建议最多提供10个候选关键词
+
+搜索建议内容可为任意语言（中 英 日等....），中文拼音支持全拼联想词
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| --------- | ---- | ---------------------- | ------ | ------------------------ |
+| term | str | 需要获得建议的输入内容 | 必要 | |
+| main_ver | str | v1 | 非必要 | 固定为`v1` |
+| highlight | str | 任意 | 非必要 | 有此项开启关键词高亮标签 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ---- | ------------ | ------------ |
+| code | num | 返回值 | 0：成功 |
+| cost | obj | 详细搜索用时 | 大概是吧？ |
+| result | obj | 搜索建议结果 | |
+| page caches | obj | ？？？ | 作用尚不明确 |
+| sengine | obj | ？？？ | 作用尚不明确 |
+| stoken | str | ？？？ | 作用尚不明确 |
+
+`cost`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ---- | -------- | ---- |
+| about | obj | 套了个娃 | |
+
+`cost`中的`about`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------ | ---- | ---- | ---- |
+| params_check | str | | |
+| total | str | | |
+| main_handler | str | | |
+
+`result`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ----- | -------- | ---- |
+| tag | array | 套了个娃 | |
+
+`result`中的`tag`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ------------------- | ---------------------- |
+| 0 | obj | 第1建议关键词 | |
+| n | obj | 第（n+1）建议关键词 | 按照相关程度与热度顺序 |
+| 9 | obj | 第10建议关键词 | 最后一项 |
+
+`tag`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----- | ---- | ---------- | ------------------------------------------------------------ |
+| value | str | 关键词内容 | |
+| ref | num | 0 | 作用尚不明确 |
+| name | str | 显示内容 | 在无高亮显示时与`value`相同查看响应示例：
+ +```json +{ + "count": 4, + "like": 42, + "title": "EVA Q 绫波丽", + "hit_columns": [ + "title" + ], + "rank_offset": 1, + "cover": "http://i0.hdslb.com/bfs/album/1043ee70b677c9aab406142c6aa00d097be07c1e.jpg", + "mid": 3306217, + "uname": "迷失人形LLS", + "rank_index": 0, + "view": 100924, + "type": "photo", + "id": 8952802, + "rank_score": 25315 +} +``` + +有高亮显示时带有``的xml标签 | +| spid | num | ？？？ | 作用尚不明确 | + +`page caches`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | ---- | ------------ | +| save cache | str | no | 作用尚不明确 | + +`sengine`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ---- | ------------ | +| usage | num | 0 | 作用尚不明确 | + +**示例：** + +获取关于`lei`的搜索建议，关键词带有高亮 + +```shell +curl -G 'https://s.search.bilibili.com/main/suggest' \ +--data-urlencode 'term=lei' \ +--data-urlencode 'main_ver=v1' \ +--data-urlencode 'highlight=' +``` + +
+
diff --git a/docs/user/check_nickname.md b/docs/user/check_nickname.md
new file mode 100644
index 0000000000..add987e022
--- /dev/null
+++ b/docs/user/check_nickname.md
@@ -0,0 +1,137 @@
+# 检查昵称是否可注册
+
+- [检查昵称](#检查昵称)
+
+---
+
+## 检查昵称
+
+> https://passport.bilibili.com/web/generic/check/nickname
+
+*请求方式:GET*
+
+也可用于判断指定昵称的用户是否存在
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| -------- | ---- | ----------- | ------ | ---- |
+| nickName | str | 目标昵称 | 必要 | 最长为16字符 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 状态码 | -400：请求错误查看响应示例：
+ +```json +{ + "code": 0, + "cost": { + "about": { + "params_check": "0.000103", + "total": "0.011644", + "main_handler": "0.011472" + } + }, + "result": { + "tag": [ + { + "value": "雷军", + "ref": 0, + "name": "雷军", + "spid": 1 + }, + { + "value": "雷之律者", + "ref": 0, + "name": "雷之律者", + "spid": 5 + }, + { + "value": "LEI神", + "ref": 0, + "name": "LEI神", + "spid": 5 + }, + { + "value": "LEIGH ELLEXSON", + "ref": 0, + "name": "LEIGH ELLEXSON", + "spid": 5 + }, + { + "value": "LEICA Q2", + "ref": 0, + "name": "LEICA Q2", + "spid": 5 + }, + { + "value": "LEIGHANNE", + "ref": 0, + "name": "LEIGHANNE", + "spid": 0 + }, + { + "value": "雷达探测姬", + "ref": 0, + "name": "雷达探测姬", + "spid": 5 + }, + { + "value": "雷律", + "ref": 0, + "name": "雷律", + "spid": 5 + }, + { + "value": "雷霆嘎巴", + "ref": 0, + "name": "雷霆嘎巴", + "spid": 5 + }, + { + "value": "雷霆沙赞", + "ref": 0, + "name": "雷霆沙赞", + "spid": 5 + } + ] + }, + "page caches": { + "save cache": "no" + }, + "sengine": { + "usage": 0 + }, + "stoken": "12344377692164099019" +} +``` + +-500：服务器端异常
**详细说明见下一表格** | +| message | str | 错误详情 | 若昵称可用，则不返回message | + +`code`状态码： + +| 值 | 含义 | +| ----- | --------------------------------- | +| 0 | 昵称未被注册 | +| 2001 | 该昵称已被他人使用 | +| 40002 | 昵称包含敏感信息 | +| 40004 | 昵称不可包含除\-和_以外的特殊字符 | +| 40005 | 昵称过长（超过16字符） | +| 40006 | 昵称过短（少于2字符） | +| 40014 | 昵称已存在 | + +**示例：** + +查询昵称 `xijinping` 是否被使用： + +```shell +curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \ +--data-urlencode 'nickName=xijinping' +``` + +
+
+
+查询昵称 `//` 是否被使用：
+
+```shell
+curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \
+--data-urlencode 'nickName=//'
+```
+
+查看响应示例：
+ +```json +{ + "code":40002, + "message":"昵称包含敏感信息" +} +``` + +
+
+
+查询昵称 `test0000000000000 ` 是否被使用：
+
+```shell
+curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \
+--data-urlencode 'nickName=test0000000000000 '
+```
+
+查看响应示例：
+ +```json +{ + "code": 40004, + "message": "昵称不可包含除-和_以外的特殊字符" +} +``` + +
+
+
+查询昵称 `0` 是否被使用：
+
+```shell
+curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \
+--data-urlencode 'nickName=0'
+```
+
+查看响应示例：
+ +```json +{ + "code": 40005, + "message": "昵称过长" +} +``` + +
+
+
+查询昵称 `test` 是否被使用：
+
+```shell
+curl -G 'https://passport.bilibili.com/web/generic/check/nickname' \
+--data-urlencode 'nickName=test'
+```
+
+查看响应示例：
+ +```json +{ + "code": 40006, + "message": "昵称过短" +} +``` + +
+
diff --git a/docs/user/contract.md b/docs/user/contract.md
new file mode 100644
index 0000000000..7080164a74
--- /dev/null
+++ b/docs/user/contract.md
@@ -0,0 +1,131 @@
+# 加入老粉计划
+
+> https://api.bilibili.com/x/v1/contract/add_contract
+
+*请求方式：POST*
+
+是否需要登录：`是`
+
+认证方式：Cookie(SESSDATA)
+
+**正文参数 (application/x-www-form-urlencoded)：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|----------|-----|--------|-----|-----|
+| aid | str | `空串` | | |
+| up_mid | str | UP主UID | 必要 | |
+| source | str | `4` | | |
+| scene | str | `105` | | |
+| platform | str | `web` | | |
+| mobi_app | str | `pc` | | |
+| csrf | str | 用户csrf | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段名 | 类型 | 内容 | 备注 |
+|---------|-----|------|-------------------------|
+| code | num | 响应码 | 0：成功查看响应示例：
+ +```json +{ + "code":40014, + "message":"昵称已存在" +} +``` + +158001：`不满足条件` | +| message | str | 0 | | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|---------------|------|-----------------------------------|-----| +| allow_message | bool | `true` | | +| input_text | str | `UP主加油！看好你噢` | | +| input_title | str | `感谢你对UP主的特别支持，“老粉”可期！私信留言鼓励下TA吧 ` | | + +**示例：** + +```shell +curl --location --request POST 'https://api.bilibili.com/x/v1/contract/add_contract' \ +--header 'Cookie: SESSDATA=xxx' \ +--header 'Content-Type: application/x-www-form-urlencoded' \ +--data-urlencode 'up_mid=2' \ +--data-urlencode 'csrf=xxx' +``` + +
+
+
+# 老粉计划发送留言
+
+> https://api.bilibili.com/x/v1/contract/add_message
+
+*请求方式：POST*
+
+认证方式：Cookie (SESSDATA)
+
+**正文参数 (application/x-www-form-urlencoded)：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|---------|-----|--------|-----|-----|
+| aid | str | `空串` | | |
+| up_mid | str | UP主UID | 必要 | |
+| source | str | `4` | | |
+| scene | str | `105` | | |
+| content | str | 留言内容 | 必要 | |
+| csrf | str | 用户csrf | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段名 | 类型 | 内容 | 备注 |
+|---------|-----|------|------------------------------|
+| code | num | 响应码 | 0：成功点击查看
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "allow_message": true, + "input_text": "UP主加油！看好你噢", + "input_title": "感谢你对UP主的特别支持，“老粉”可期！私信留言鼓励下TA吧 " + } +} +``` + +158005：您跟up主还不是契约关系 | +| message | str | 0 | | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|---------------|-----|------------------|-----| +| success_toast | str | `提交成功，UP主已收到留言~` | | + +**示例：** + +```shell +curl --location --request POST 'https://api.bilibili.com/x/v1/contract/add_message' \ +--header 'Cookie: SESSDATA=xxx' \ +--header 'Content-Type: application/x-www-form-urlencoded' \ +--data-urlencode 'up_mid=2' \ +--data-urlencode 'content=..' \ +--data-urlencode 'csrf=xxx' +``` + +
+
\ No newline at end of file
diff --git a/docs/user/info.md b/docs/user/info.md
new file mode 100644
index 0000000000..ecd4263eb0
--- /dev/null
+++ b/docs/user/info.md
@@ -0,0 +1,1229 @@
+# 用户基本信息
+
+点击查看
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "success_toast": "提交成功，UP主已收到留言~" + } +} +``` + +
+
+- [用户空间详细信息](#用户空间详细信息)
+- [用户名片信息](#用户名片信息)
+- [登录用户空间详细信息](#登录用户空间详细信息)
+- [多用户详细信息](#多用户详细信息)
+
+---
+
+## 用户空间详细信息
+
+> https://api.bilibili.com/x/space/acc/info
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|---------|-----|-----|
+| mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|---------------------|
+| code | num | 返回值 | 0：成功-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|------------------|------|------------|--------------------------------------------------------------------------------------------------| +| mid | num | mid | | +| name | str | 昵称 | | +| sex | str | 性别 | 男/女/保密 | +| face | str | 头像链接 | | +| face_nft | num | 是否为 nft 头像 | `0`不是nft头像
`1`是 nft 头像 | +| face_nft_type | num | | 0,1 | +| sign | str | 签名 | | +| rank | num | 用户权限等级 | 目前应该无任何作用
5000：0级未答题
10000：普通会员
20000：字幕君
25000：VIP
30000：真·职人
32000：管理员 | +| level | num | 当前等级 | 0-6级 | +| jointime | num | 注册时间 | 此接口返回恒为`0` | +| moral | num | 节操值 | 此接口返回恒为`0` | +| silence | num | 封禁状态 | 0：正常
1：被封 | +| coins | num | 硬币数 | 需要登录(Cookie)
只能查看自己的
默认为0 | +| fans_badge | bool | 是否具有粉丝勋章 | false：无
true：有 | +| fans_medal | obj | 粉丝勋章信息 | | +| official | obj | 认证信息 | | +| vip | obj | 会员信息 | | +| pendant | obj | 头像框信息 | | +| nameplate | obj | 勋章信息 | | +| user_honour_info | obj | | | +| is_followed | bool | 是否关注此用户 | true：已关注
false：未关注
需要登录(Cookie)
未登录恒为false | +| top_photo | str | 主页头图链接 | | +| theme | obj | 空 | **作用尚不明确** | +| sys_notice | obj | 系统通知 | 无内容则为空对象
主要用于展示如用户争议、纪念账号等等 | +| live_room | obj | 直播间信息 | | +| birthday | str | 生日 | MM-DD
如设置隐私为空 | +| school | obj | 学校 | | +| profession | obj | 专业资质信息 | | +| tags | null | 个人标签 | | +| series | obj | | | +| is_senior_member | num | 是否为硬核会员 | 0：否
1：是 | +| mcn_info | null | | | +| gaia_res_type | num | | | +| gaia_data | null | | | +| is_risk | bool | | | +| elec | obj | 充电信息 | | +| contract | obj | 是否显示老粉计划 | | + +`rank`示例 + +| UID | rank | +|-----------|-------| +| 2 | 20000 | +| 16765 | 20000 | +| 15773384 | 20000 | +| 124416 | 20000 | +| 429736362 | 25000 | +| 424261768 | 25000 | +| 41273726 | 25000 | +| 15080107 | 25000 | +| 9847497 | 25000 | +| 4856007 | 25000 | +| 928123 | 25000 | +| 132704 | 25000 | +| 70093 | 25000 | +| 47291 | 25000 | +| 27380 | 25000 | +| 22445 | 25000 | +| 3351 | 25000 | +| 1101 | 25000 | +| 93066 | 30000 | +| 2443068 | 30000 | +| 46368 | 30000 | +| 11167 | 30000 | + +`profession`示例 + +| UID | +|------------| +| 654391 | +| 1440295 | +| 1785155 | +| 2990100 | +| 3875803 | + +`data`中的`official`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-----|------|-----------------------------------------| +| role | num | 认证类型 | 0：无
1 2 7 9：个人认证
3 4 5 6：机构认证 | +| title | str | 认证信息 | 无为空 | +| desc | str | 认证备注 | 无为空 | +| type | num | 是否认证 | -1：无
0：个人认证
1：机构认证 | + +`data`中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +|----------------------|-----|-----------|----------------------------------------------| +| type | num | 会员类型 | 0：无
1：月大会员
2：年度及以上大会员 | +| status | num | 会员状态 | 0：无
1：有 | +| due_date | num | 会员过期时间 | Unix时间戳(毫秒) | +| vip_pay_type | num | 支付类型 | 0：未支付（常见于官方账号）
1：已支付（以正常渠道获取的大会员均为此值） | +| theme_type | num | 0 | 作用尚不明确 | +| label | obj | 会员标签 | | +| avatar_subscript | num | 是否显示会员图标 | 0：不显示
1：显示 | +| nickname_color | str | 会员昵称颜色 | 颜色码，一般为`#FB7299`，曾用于愚人节改变大会员配色 | +| role | num | 大角色类型 | 1：月度大会员
3：年度大会员
7：十年大会员
15：百年大会员 | +| avatar_subscript_url | str | 大会员角标地址 | | +| tv_vip_status | num | 电视大会员状态 | 0：未开通 | +| tv_vip_pay_type | num | 电视大会员支付类型 | | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------------------------|------|----------|------------------------------------------------------------------------------------------------------------------------------| +| path | str | 空 | 作用尚不明确 | +| text | str | 会员类型文案 | `大会员` `年度大会员` `十年大会员` `百年大会员` `最强绿鲤鱼` | +| label_theme | str | 会员标签 | vip：大会员
annual_vip：年度大会员
ten_annual_vip：十年大会员
hundred_annual_vip：百年大会员
fools_day_hundred_annual_vip：最强绿鲤鱼 | +| text_color | str | 会员标签 | | +| bg_style | num | 1 | | +| bg_color | str | 会员标签背景颜色 | 颜色码，一般为`#FB7299`，曾用于愚人节改变大会员配色 | +| border_color | str | 会员标签边框颜色 | 未使用 | +| use_img_label | bool | `true` | | +| img_label_uri_hans | str | `空串` | | +| img_label_uri_hant | str | `空串` | | +| img_label_uri_hans_static | str | 大会员牌子图片 | 简体版 | +| img_label_uri_hant_static | str | 大会员牌子图片 | 繁体版 | + + +`data`中的`pendant`对象： + +**普通头像框的`image`与`image_enhance`内容相同** +**动态头像框的`image`为png静态图片，`image_enhance`为webp动态图片，`image_enhance_frame`为png逐帧序列** + +| 字段 | 类型 | 内容 | 备注 | +|---------------------|-----|--------------|------------| +| pid | num | 头像框id | | +| name | str | 头像框名称 | | +| image | str | 头像框图片url | | +| expire | num | 过期时间 | 此接口返回恒为`0` | +| image_enhance | str | 头像框图片url | | +| image_enhance_frame | str | 头像框图片逐帧序列url | | + +`data`中的`nameplate`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------------|-----|---------|-----| +| nid | num | 勋章id | | +| name | str | 勋章名称 | | +| image | str | 勋章图标 | | +| image_small | str | 勋章图标（小） | | +| level | str | 勋章等级 | | +| condition | str | 获取条件 | | + +`data`中的`fans_medal`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|------|-----------|-----| +| show | bool | | | +| wear | bool | 是否佩戴了粉丝勋章 | | +| medal | obj | 粉丝勋章信息 | | + +`fans_medal`中的`medal`对象： + +| 字段 | 类型 | 内容 | 备注 | +|--------------------|-----|--------------|------------------| +| uid | num | 此用户mid | | +| target_id | num | 粉丝勋章所属UP的mid | | +| medal_id | num | 粉丝勋章id | | +| level | num | 粉丝勋章等级 | | +| medal_name | str | 粉丝勋章名称 | | +| medal_color | num | 颜色 | | +| intimacy | num | 当前亲密度 | | +| next_intimacy | num | 下一等级所需亲密度 | | +| day_limit | num | 每日亲密度获取上限 | | +| today_feed | num | 今日已获得亲密度 | | +| medal_color_start | num | 粉丝勋章颜色 | 十进制数，可转为十六进制颜色代码 | +| medal_color_end | num | 粉丝勋章颜色 | 十进制数，可转为十六进制颜色代码 | +| medal_color_border | num | 粉丝勋章边框颜色 | 十进制数，可转为十六进制颜色代码 | +| is_lighted | num | | | +| light_status | num | | | +| wearing_status | num | 当前是否佩戴 | 0：未佩戴
1：已佩戴 | +| score | num | | | + +`data`中的`sys_notice`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------------|-----|------|-----| +| id | num | id | | +| content | str | 显示文案 | | +| url | str | 跳转地址 | | +| notice_type | num | 提示类型 | 1,2 | +| icon | str | 前缀图标 | | +| text_color | str | 文字颜色 | | +| bg_color | str | 背景颜色 | | + +`sys_notice`示例 + +| id | content | url | notice_type | 示例用户 | +|-----|-------------------------------------------------|-----|-------------|-------------------------------------------------------------------------------------------------| +| 5 | 该用户存在争议行为，已冻结其帐号功能的使用 | | 1 | [82385070](https://space.bilibili.com/82385070) | +| 8 | 该用户存在较大争议，请谨慎甄别其内容 | | 1 | [28062215](https://space.bilibili.com/28062215) | +| 11 | 该账号涉及合约争议，暂冻结其账号功能使用。详见公告-> | | 1 | +| 16 | 该UP主内容存在争议，请注意甄别视频内信息 | | 1 | [382534165](https://space.bilibili.com/382534165) | +| 20 | 请允许我们在此献上最后的告别，以此纪念其在哔哩哔哩留下的回忆与足迹。请点此查看纪念账号相关说明 | | 2 | +| 22 | 该账号涉及合约诉讼，封禁其账号使用。 | | +| 24 | 该账号涉及合约争议，暂冻结其账号功能使用。 | | 1 | [291229008](https://space.bilibili.com/291229008) | +| 25 | 该用户涉及严重指控，暂冻结其账号功能使用 | | 1 | [81447581](https://space.bilibili.com/81447581) | +| 31 | 该用户涉及严重指控，暂冻结其账号功能使用 | | 1 | [22439273](https://space.bilibili.com/22439273) | +| 34 | 该用户涉及严重指控，暂冻结其账号功能使用 | | 1 | [1640486775](https://space.bilibili.com/1640486775) | +| 36 | 该账户存在争议，请谨慎甄别 | | 1 | [198297](https://space.bilibili.com/198297)
[18149131](https://space.bilibili.com/18149131) | + +`data`中的`live_room`对象： + +| 字段 | 类型 | 内容 | 备注 | +|----------------|-----|------------|------------------| +| roomStatus | num | 直播间状态 | 0：无房间
1：有房间 | +| liveStatus | num | 直播状态 | 0：未开播
1：直播中 | +| url | str | 直播间网页 url | | +| title | str | 直播间标题 | | +| cover | str | 直播间封面 url | | +| watched_show | obj | | | +| roomid | num | 直播间 id(短号) | | +| roundStatus | num | 轮播状态 | 0：未轮播
1：轮播 | +| broadcast_type | num | 0 | | + +`live_room`中的`watched_show`对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------------|------|---------------------|-----| +| switch | bool | ? | | +| num | num | total watched users | | +| text_small | str | | | +| text_large | str | | | +| icon | str | watched icon url | | +| icon_location | str | ? | | +| icon_web | str | watched icon url | | + +`data`中的`school`对象： + +| 字段 | 类型 | 内容 | 备注 | +|------|-----|--------|-------| +| name | str | 就读大学名称 | 没有则为空 | + +`data`中的`profession`对象： + +| 字段 | 类型 | 内容 | 备注 | +|------------|-----|------|----------------| +| name | str | 资质名称 | | +| department | str | 职位 | | +| title | str | 所属机构 | | +| is_show | num | 是否显示 | 0：不显示
1：显示 | + +`data`中的`user_honour_info`对象： + +| 字段 | 类型 | 内容 | 备注 | +|--------|-------|------|-----| +| mid | num | 0 | | +| colour | str | null | | +| tags | array | null | | + +`data`中的`series`对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------------------|------|-----|-----| +| user_upgrade_status | num | (?) | | +| show_upgrade_window | bool | (?) | | + +`data`中的`elec`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-----------|-----|-----|-----| +| show_info | obj | | | + +`elec`中的`show_info`对象： + +| 字段 | 类型 | 内容 | 备注 | +|----------|------|---------|------------------| +| show | bool | 是否开通了充电 | | +| state | num | 状态 | -1：未开通
1：已开通 | +| title | str | `空串` | | +| icon | str | `空串` | | +| jump_url | str | `空串` | | + +`data`中的`contract`对象： + +| 字段名 | 类型 | 内容 | 备注 | +|-------------------|------|-----------|---------------------------| +| is_display | bool | | true/false
在页面中未使用此字段 | +| is_follow_display | bool | 是否在显示老粉计划 | true：显示
false：不显示 | + +**示例：** + +查询用户`mid=2`的详细信息 + +```shell +curl -G 'https://api.bilibili.com/x/space/acc/info' \ +--data-urlencode 'mid=2' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+**查询到的信息解析如下：**
+
+**用户昵称为**：碧诗
+
+**性别**：男
+
+**用户的头像为**：
+
+https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 2, + "name": "碧诗", + "sex": "男", + "face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", + "face_nft": 0, + "face_nft_type": 0, + "sign": "https://kami.im 直男过气网红 # We Are Star Dust", + "rank": 20000, + "level": 6, + "jointime": 0, + "moral": 0, + "silence": 0, + "coins": 0, + "fans_badge": true, + "fans_medal": { + "show": true, + "wear": true, + "medal": { + "uid": 2, + "target_id": 335115, + "medal_id": 45408, + "level": 21, + "medal_name": "伍千万", + "medal_color": 1725515, + "intimacy": 1980, + "next_intimacy": 2000, + "day_limit": 250000, + "medal_color_start": 1725515, + "medal_color_end": 5414290, + "medal_color_border": 1725515, + "is_lighted": 1, + "light_status": 1, + "wearing_status": 1, + "score": 50001980 + } + }, + "official": { + "role": 2, + "title": "bilibili创始人（站长）", + "desc": "", + "type": 0 + }, + "vip": { + "type": 2, + "status": 1, + "due_date": 3909916800000, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "十年大会员", + "label_theme": "ten_annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "", + "use_img_label": true, + "img_label_uri_hans": "", + "img_label_uri_hant": "", + "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/activity-plat/static/20221008/0597543265563f522fad443825cff578/O9l2i8GdaZ.png", + "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/8u7iRTPE7N.png" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 7, + "avatar_subscript_url": "", + "tv_vip_status": 1, + "tv_vip_pay_type": 0 + }, + "pendant": { + "pid": 32257, + "name": "EveOneCat2", + "image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png", + "expire": 0, + "image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp", + "image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png" + }, + "nameplate": { + "nid": 10, + "name": "见习偶像", + "image": "https://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png", + "image_small": "https://i1.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png", + "level": "普通勋章", + "condition": "所有自制视频总播放数>=10万" + }, + "user_honour_info": { + "mid": 0, + "colour": null, + "tags": [] + }, + "is_followed": false, + "top_photo": "http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png", + "theme": {}, + "sys_notice": {}, + "live_room": { + "roomStatus": 1, + "liveStatus": 0, + "url": "https://live.bilibili.com/1024?broadcast_type=0&is_room_feed=0", + "title": "试图恰鸡", + "cover": "http://i0.hdslb.com/bfs/live/new_room_cover/96ee5bfd0279a0f18b190340334f43f473038288.jpg", + "roomid": 1024, + "roundStatus": 0, + "broadcast_type": 0, + "watched_show": { + "switch": true, + "num": 14, + "text_small": "14", + "text_large": "14人看过", + "icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png", + "icon_location": "", + "icon_web": "https://i0.hdslb.com/bfs/live/8d9d0f33ef8bf6f308742752d13dd0df731df19c.png" + } + }, + "birthday": "09-19", + "school": { + "name": "" + }, + "profession": { + "name": "", + "department": "", + "title": "", + "is_show": 0 + }, + "tags": null, + "series": { + "user_upgrade_status": 3, + "show_upgrade_window": false + }, + "is_senior_member": 1, + "mcn_info": null, + "gaia_res_type": 0, + "gaia_data": null, + "is_risk": false, + "elec": { + "show_info": { + "show": true, + "state": 1, + "title": "", + "icon": "", + "jump_url": "" + } + } + } +} +``` + +
+
+**等级**：6级
+
+**生日**：09-19
+
+**粉丝勋章状态**：拥有
+
+**认证**：个人认证
+
+**认证名称**： bilibili创始人(站长)
+
+**大会员类型**：年度
+
+**大会员状态**：已开通
+
+**电视大会员状态**：已开通
+
+**头像框**：EveOneCat2
+
+https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp
+
+
+
+**粉丝勋章**： 见习偶像
+
+https://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png
+
+
+
+**空间头图**：
+
+https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
+
+
+
+## 用户名片信息
+
+> https://api.bilibili.com/x/web-interface/card
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------------------- | ------ | ----------------------- |
+| mid | num | 目标用户mid | 必要 | |
+| photo | bool | 是否请求用户主页头图 | 非必要 | true：是false：否 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | -------------- | ------------------------------------------------------------ | +| card | obj | 卡片信息 | | +| following | bool | 是否关注此用户 | true：已关注
false：未关注
需要登录(Cookie)
未登录为false | +| archive_count | num | 用户稿件数 | | +| article_count | num | 0 | **作用尚不明确** | +| follower | num | 粉丝数 | | +| like_num | num | 点赞数 | | + +`data`中的`card`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ----- | -------------- | ------------------------------------------------------------ | +| mid | str | 用户mid | | +| approve | bool | false | **作用尚不明确** | +| name | str | 用户昵称 | | +| sex | str | 用户性别 | 男 女 保密 | +| face | str | 用户头像链接 | | +| DisplayRank | str | 0 | **作用尚不明确** | +| regtime | num | 0 | **作用尚不明确** | +| spacesta | num | 0 | **作用尚不明确** | +| birthday | str | 空 | **作用尚不明确** | +| place | str | 空 | **作用尚不明确** | +| description | str | 空 | **作用尚不明确** | +| article | num | 0 | **作用尚不明确** | +| attentions | array | 空 | **作用尚不明确** | +| fans | num | 粉丝数 | | +| friend | num | 关注数 | | +| attention | num | 关注数 | | +| level_info | obj | 等级 | | +| pendant | obj | 挂件 | | +| nameplate | obj | 勋章 | | +| Official | obj | 认证信息 | | +| official_verify | obj | 认证信息2 | | +| vip | obj | 大会员状态 | | +| space | obj | 主页头图 | | + +`card`中的`level_info`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | -------- | ---------------- | +| current_level | num | 当前等级 | 0-6级 | +| current_min | num | 0 | 作用尚不明确 | +| current_exp | num | 0 | **作用尚不明确** | +| next_exp | num | 0 | **作用尚不明确** | + +`card`中的`pendant`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ----------- | ---------------- | +| pid | num | 挂件id | | +| name | str | 挂件名称 | | +| image | str | 挂件图片url | | +| expire | num | 0 | **作用尚不明确** | + +`card`中的`nameplate`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ---------------- | -------------------- | +| nid | num | 勋章id | **详细说明有待补充** | +| name | str | 勋章名称 | | +| image | str | 挂件图片url 正常 | | +| image_small | str | 勋章图片url 小 | | +| level | str | 勋章等级 | | +| condition | str | 勋章条件 | | + +`card`中的`Official`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | -------- | ------------------------------------------------- | +| role | num | 认证类型 | 0：无
1 2 7：个人认证
3 4 5 6：机构认证 | +| title | str | 认证信息 | 无为空 | +| desc | str | 认证备注 | 无为空 | +| type | num | 是否认证 | -1：无
0：认证 | + +`card`中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | ------------------- | +| type | num | 是否认证 | -1：无
0：认证 | +| desc | str | 认证信息 | 无为空 | + +`card`中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ---------- | ------------------------------------------------- | +| vipType | num | 大会员类型 | 0：无
1：月度大会员
2：年度及以上大会员 | +| dueRemark | str | 空 | **作用尚不明确** | +| accessStatus | num | 0 | **作用尚不明确** | +| vipStatus | num | 大会员状态 | 0：无
1：有 | +| vipStatusWarn | str | 空 | **作用尚不明确** | +| theme_type | num | 0 | **作用尚不明确** | + +`card`中的`space`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ---------------- | ---- | +| s_img | str | 主页头图url 小图 | | +| l_img | str | 主页头图url 正常 | | + +**示列：** + +```shell +curl -G 'api.bilibili.com/x/web-interface/card' \ +--data-urlencode 'mid=2' \ +--data-urlencode 'photo=true' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 登录用户空间详细信息
+
+> https://api.bilibili.com/x/space/myinfo
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "card": { + "mid": "2", + "name": "碧诗", + "approve": false, + "sex": "男", + "rank": "20000", + "face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", + "DisplayRank": "0", + "regtime": 0, + "spacesta": 0, + "birthday": "", + "place": "", + "description": "", + "article": 0, + "attentions": [], + "fans": 969999, + "friend": 234, + "attention": 234, + "sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”", + "level_info": { + "current_level": 6, + "current_min": 0, + "current_exp": 0, + "next_exp": 0 + }, + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0, + "image_enhance": "", + "image_enhance_frame": "" + }, + "nameplate": { + "nid": 10, + "name": "见习偶像", + "image": "http://i2.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png", + "image_small": "http://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png", + "level": "普通勋章", + "condition": "所有自制视频总播放数\u003e=10万" + }, + "Official": { + "role": 2, + "title": "bilibili创始人（站长）", + "desc": "", + "type": 0 + }, + "official_verify": { + "type": 0, + "desc": "bilibili创始人（站长）" + }, + "vip": { + "type": 2, + "status": 1, + "due_date": 3896524800000, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "十年大会员", + "label_theme": "ten_annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 7, + "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png", + "vipType": 2, + "vipStatus": 1 + } + }, + "space": { + "s_img": "http://i1.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png", + "l_img": "http://i1.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png" + } + }, + "following": true, + "archive_count": 37, + "article_count": 0, + "follower": 969999, + "like_num": 3547978 +} +``` + +-101：未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | ------------ | ------------------------ | +| mid | num | mid | | +| name | str | 昵称 | | +| sex | str | 性别 | 男 女 保密 | +| face | str | 头像图片url | | +| sign | str | 签名 | | +| rank | num | 10000 | **作用尚不明确** | +| level | num | 当前等级 | 0-6级 | +| jointime | num | 0 | **作用尚不明确** | +| moral | num | 节操 | 默认70 | +| silence | num | 封禁状态 | 0：正常
1：被封 | +| email_status | num | 已验证邮箱 | 0：未验证
1：已验证 | +| tel_status | num | 已验证手机号 | 0：未验证
1：已验证 | +| identification | num | 1 | **作用尚不明确** | +| vip | obj | 大会员状态 | | +| birthday | num | 生日 | 时间戳 | +| is_tourist | num | 0 | **作用尚不明确** | +| is_fake_account | num | 0 | **作用尚不明确** | +| pin_prompting | num | 0 | **作用尚不明确** | +| is_deleted | num | 0 | **作用尚不明确** | +| coins | num | 硬币数 | | +| following | num | 粉丝数 | | +| follower | num | 粉丝数 | | + +`data`中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------------- | ---- | ---------------- | ----------------------------------------------- | +| type | num | 会员类型 | 0：无
1：月大会员
2：年度及以上大会员 | +| status | num | 会员状态 | 0：无
1：有 | +| due_date | num | 会员过期时间 | Unix时间戳(毫秒) | +| theme_type | num | 0 | 作用尚不明确 | +| label | obj | 会员标签 | | +| avatar_subscript | num | 是否显示会员图标 | 0：不显示
1：显示 | +| nickname_color | str | 会员昵称颜色 | 颜色码 | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | -------- | ------------------------------------------------------------ | +| path | str | 空 | 作用尚不明确 | +| text | str | 会员名称 | | +| label_theme | str | 会员标签 | vip：大会员
annual_vip：年度大会员
ten_annual_vip：十年大会员
hundred_annual_vip：百年大会员 | + +`data`中的`pendant`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ----------- | -------------------- | +| pid | num | 挂件id | **详细说明有待补充** | +| name | str | 挂件名称 | | +| image | str | 挂件图片url | | +| expire | num | 0 | **作用尚不明确** | + +`data`中的`nameplate`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ---------------- | -------------------- | +| nid | num | 勋章id | **详细说明有待补充** | +| name | str | 勋章名称 | | +| image | str | 挂件图片url 正常 | | +| image_small | str | 勋章图片url 小 | | +| level | str | 勋章等级 | | +| condition | str | 勋章条件 | | + +`data`中的`Official`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | -------- | ------------------------------------------------- | +| role | num | 认证类型 | 0：无
1 2 7：个人认证
3 4 5 6：机构认证 | +| title | str | 认证信息 | 无为空 | +| desc | str | 认证备注 | 无为空 | +| type | num | 是否认证 | -1：无
0：认证 | + +`data`中的`level_exp`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | -------- | ---------------- | +| current_level | num | 当前等级 | 0-6级 | +| current_min | num | 0 | 指当前等级从多少经验值开始 | +| current_exp | num | 0 | 当前账户的经验值 | +| next_exp | num | 0 | 下一个等级所需的经验值**(不是还需要多少)** | + +**示例：** + +```shell +curl -G 'api.bilibili.com/x/space/myinfo' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 多用户详细信息
+
+> https://api.vc.bilibili.com/account/v1/user/cards
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------------- | ------ | --------------------------------- |
+| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔，最多50个成员 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----- | -------- | ----------------------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 293793435, + "name": "社会易姐QwQ", + "sex": "男", + "face": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", + "sign": "高考刚结束的普通技术宅一枚，喜欢MC和编程以及电子，是车车人也是术术人，粉丝群:1136462265", + "rank": 10000, + "level": 5, + "jointime": 0, + "moral": 70, + "silence": 0, + "email_status": 1, + "tel_status": 1, + "identification": 1, + "vip": { + "type": 2, + "status": 1, + "due_date": 1644163200000, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 3, + "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png" + }, + "pendant": { + "pid": 2511, + "name": "初音未来13周年", + "image": "http://i0.hdslb.com/bfs/garb/item/4f8f3f1f2d47f0dad84f66aa57acd4409ea46361.png", + "expire": 0, + "image_enhance": "http://i0.hdslb.com/bfs/garb/item/fe0b83b53e2342b16646f6e7a9370d8a867decdb.webp", + "image_enhance_frame": "http://i0.hdslb.com/bfs/garb/item/127c507ec8448be30cf5f79500ecc6ef2fd32f2c.png" + }, + "nameplate": { + "nid": 4, + "name": "青铜殿堂", + "image": "http://i0.hdslb.com/bfs/face/2879cd5fb8518f7c6da75887994c1b2a7fe670bd.png", + "image_small": "http://i0.hdslb.com/bfs/face/6707c120e00a3445933308fd9b7bd9fad99e9ec4.png", + "level": "普通勋章", + "condition": "单个自制视频总播放数\u003e=1万" + }, + "official": { + "role": 0, + "title": "", + "desc": "", + "type": -1 + }, + "birthday": 1015257600, + "is_tourist": 0, + "is_fake_account": 0, + "pin_prompting": 0, + "is_deleted": 0, + "in_reg_audit": 0, + "is_rip_user": false, + "profession": { + "id": 0, + "name": "", + "show_name": "" + }, + "level_exp": { + "current_level": 5, + "current_min": 10800, + "current_exp": 27125, + "next_exp": 28800 + }, + "coins": 9, + "following": 1122, + "follower": 1122 + } +} +``` + +-400：请求错误
600007：超出批量获取用户信息限制 | +| msg | str | 错误信息 | 默认为空 | +| message | str | 错误信息 | 默认为空 | +| data | array | 信息本体 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---- | +| 0 | obj | 用户1 | | +| n | obj | 用户(n+1) | | +| …… | obj | …… | …… | + +`data`数组中的对象： + +基本同「[用户空间详细信息](#用户空间详细信息)」中的data对象 + +**示例：** + +查询用户`uids=1,2,3`的详细信息 + +```shell +curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \ +--data-urlencode 'uids=1,2,3' \ +-b 'SESSDATA=xxx' +``` + +
+
diff --git a/docs/user/register.md b/docs/user/register.md
new file mode 100644
index 0000000000..daea5920e7
--- /dev/null
+++ b/docs/user/register.md
@@ -0,0 +1,102 @@
+# 用户注册
+
+
+## 人机验证
+
+[完成人机验证(参考验证登录)](../login/login_action/readme.md#验证登录)
+
+完成后得到`key`, `challenge`, `validate`, `seccode`四个参数
+
+
+## 发送短信验证码
+
+[发送短信验证码(参考短信登录)](../login/login_action/SMS.md#发送短信验证码（web端）)
+
+**注意不同的是这里type=1而非21**,推测此参数决定短信内容
+
+```bash
+curl 'https://passport.bilibili.com/web/sms/general/v2/send' \
+ --data-urlencode 'key=6eeb28e7bbd64b389da2be3a2778c7e3' \
+ --data-urlencode 'captchaType=6' \
+ --data-urlencode 'type=1' \
+ --data-urlencode 'cid=1' \
+ --data-urlencode 'tel=13888888888' \
+ --data-urlencode 'challenge=c52148f88a28b6011db52bb213483ee8' \
+ --data-urlencode 'validate=a98841cd6ea58e1b1f5783fca73cddb6' \
+ --data-urlencode 'seccode=a98841cd6ea58e1b1f5783fca73cddb6|jordan'
+```
+
+查看响应示例：
+ +```json +{ + "code": 0, + "msg": "", + "message": "", + "data": [{ + "mid": 1, + "name": "bishi", + "sex": "男", + "face": "https://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif", + "sign": "", + "rank": 10000, + "level": 4, + "silence": 0, + "vip": { + "type": 2, + "status": 1, + "due_date": 1754496000000, + "vip_pay_type": 1, + "theme_type": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "", + "use_img_label": true, + "img_label_uri_hans": "", + "img_label_uri_hant": "", + "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/8d4f8bfc713826a5412a0a27eaaac4d6b9ede1d9.png", + "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/VEW8fCC0hg.png" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 3, + "avatar_subscript_url": "", + "tv_vip_status": 0, + "tv_vip_pay_type": 0, + "tv_due_date": 1633622400 + }, + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0, + "image_enhance": "", + "image_enhance_frame": "" + }, + "nameplate": { + "nid": 0, + "name": "", + "image": "", + "image_small": "", + "level": "", + "condition": "" + }, + "official": { + "role": 0, + "title": "", + "desc": "", + "type": -1 + }, + "birthday": 622137600, + "is_fake_account": 0, + "is_deleted": 0, + "in_reg_audit": 0, + "face_nft": 0, + "face_nft_new": 0, + "is_senior_member": 0 + }, { + "mid": 2, + "name": "碧诗", + "sex": "男", + "face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", + "sign": "https://kami.im 直男过气网红 # av362830 “We Are Star Dust”", + "rank": 20000, + "level": 6, + "silence": 0, + "vip": { + "type": 2, + "status": 1, + "due_date": 3901881600000, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "十年大会员", + "label_theme": "ten_annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "", + "use_img_label": true, + "img_label_uri_hans": "", + "img_label_uri_hant": "", + "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/adb599797dd171e2d3d6d012f448b49679258344.png", + "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/sGu57N6pgK.png" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 7, + "avatar_subscript_url": "", + "tv_vip_status": 0, + "tv_vip_pay_type": 0, + "tv_due_date": 1655481600 + }, + "pendant": { + "pid": 32257, + "name": "EveOneCat2", + "image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png", + "expire": 0, + "image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp", + "image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png" + }, + "nameplate": { + "nid": 10, + "name": "见习偶像", + "image": "https://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png", + "image_small": "https://i1.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png", + "level": "普通勋章", + "condition": "所有自制视频总播放数>=10万" + }, + "official": { + "role": 2, + "title": "bilibili创始人（站长）", + "desc": "", + "type": 0 + }, + "birthday": 622137600, + "is_fake_account": 0, + "is_deleted": 0, + "in_reg_audit": 0, + "face_nft": 0, + "face_nft_new": 0, + "is_senior_member": 1 + }, { + "mid": 3, + "name": "囧囧倉", + "sex": "男", + "face": "https://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg", + "sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。", + "rank": 10000, + "level": 5, + "silence": 0, + "vip": { + "type": 0, + "status": 0, + "due_date": 0, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "", + "use_img_label": true, + "img_label_uri_hans": "", + "img_label_uri_hant": "", + "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/d7b702ef65a976b20ed854cbd04cb9e27341bb79.png", + "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/KJunwh19T5.png" + }, + "avatar_subscript": 0, + "nickname_color": "", + "role": 0, + "avatar_subscript_url": "", + "tv_vip_status": 0, + "tv_vip_pay_type": 0, + "tv_due_date": 0 + }, + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0, + "image_enhance": "", + "image_enhance_frame": "" + }, + "nameplate": { + "nid": 0, + "name": "", + "image": "", + "image_small": "", + "level": "", + "condition": "" + }, + "official": { + "role": 0, + "title": "", + "desc": "", + "type": -1 + }, + "birthday": 1262275200, + "is_fake_account": 0, + "is_deleted": 0, + "in_reg_audit": 0, + "face_nft": 0, + "face_nft_new": 0, + "is_senior_member": 0 + }] +} +``` + +
+
+
+## 提交注册请求
+
+> https://passport.bilibili.com/web/reg/tel
+
+*请求方式：POST*
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| -------- | ---- | ---------------- | ------ | ------------------------------------------------------------ |
+| cid | num | 国际冠字码 | 必要 | 可以从 [获取国际冠字码](../login/login_action/SMS.md#获取国际冠字码_web端) 接口中获取 |
+| tel | num | 手机号码 | 必要 | |
+| code | num | 短信验证码 | 必要 | |
+| nickName | str | 昵称 | 必要 | |
+| pwd | str | 密码 | 必要 | 密码为明文 |
+| plat | num | 0 | 必要 | 平台？ |
+| gourl | str | 注册成功跳转地址 | 非必要 | 默认为主页`https://www.bilibili.com/` |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ----------------------------------------------- |
+| code | num | 返回值 | 0：成功查看示例
+ +```json +{ + "code": 0, + "message": "验证码短信已下发" +} +``` + +1005：验证码错误
1007：验证码过期 | +| message | str | 错误信息 | 成功时无此字段 | +| data | obj | 信息本体 | 只在成功时存在 | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ---- | ---------- | ----------------------------- | +| redirectUrl | str | 跳转链接 | | +| hint | str | "注册成功" | 成功后不提示成功还能提示什么? | +| in_reg_audit | num | (?) | | + +```bash +curl 'https://passport.bilibili.com/web/reg/tel' \ + --data-urlencode 'plat=0' \ + --data-urlencode 'cid=1' \ + --data-urlencode 'tel=13888888888' \ + --data-urlencode 'code=121314' \ + --data-urlencode 'nickName=萌系小妹纸わ' + --data-urlencode 'pwd=Password1234' \ + --data-urlencode 'gourl=https://www.bilibili.com' +``` + +
+
\ No newline at end of file
diff --git a/docs/user/relation.md b/docs/user/relation.md
new file mode 100644
index 0000000000..f333a90793
--- /dev/null
+++ b/docs/user/relation.md
@@ -0,0 +1,2450 @@
+# 用户关系相关
+
+- [查询用户粉丝明细](#查询用户粉丝明细)
+- [查询用户关注明细](#查询用户关注明细)
+- [查询用户关注明细2](#查询用户关注明细2)
+- [搜索关注明细](#搜索关注明细)
+- [查询共同关注明细](#查询共同关注明细)
+- [查询悄悄关注明细](#查询悄悄关注明细)
+- [查询互相关注明细](#查询互相关注明细)
+- [查询黑名单明细](#查询黑名单明细)
+- [操作用户关系](#操作用户关系)
+- [批量操作用户关系](#批量操作用户关系)
+- [查询用户与自己关系_仅查关注](#查询用户与自己关系_仅查关注)
+- [查询用户与自己关系_互相](#查询用户与自己关系_互相)
+- [批量查询用户与自己关系](#批量查询用户与自己关系)
+- [关注分组相关](#关注分组相关)
+ - [查询关注分组列表](#查询关注分组列表)
+ - [查询关注分组明细](#查询关注分组明细)
+ - [查询目标用户所在的分组](#查询目标用户所在的分组)
+ - [查询所有特别关注的mid](#查询所有特别关注的mid)
+ - [创建分组](#创建分组)
+ - [重命名分组](#重命名分组)
+ - [删除分组](#删除分组)
+ - [修改分组成员](#修改分组成员)
+ - [复制关注到分组](#复制关注到分组)
+ - [移动关注到分组](#移动关注到分组)
+
+---
+
+## 查询用户粉丝明细
+
+查看示例
+ +```json +{ + "code": 0, + "data": { + "redirectUrl": "https://www.bilibili.com", + "hint": "注册成功", + "in_reg_audit": 0 + } +} +``` + +
+
+> https://api.bilibili.com/x/relation/followers
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+登录可看自己前1000名，其他用户可查看前250名（网页端请求时ps为20，所以直接查看只能看到前100名）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---------------------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| vmid | num | 目标用户mid | 必要 | |
+| ps | num | 每页项数 | 非必要 | 默认为50 |
+| pn | num | 页码 | 非必要 | 默认为1其他用户仅可查看前5页 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ------------ | +| list | array | 明细列表 | | +| re_version | num | ？？？ | 作用尚不明确 | +| total | num | 粉丝总数 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---------------- | +| 0 | obj | 粉丝1 | | +| n | obj | 粉丝(n+1) | 按照关注顺序排列 | +| …… | obj | …… | …… | + +`list`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | ------------ | --------------------------------------- | +| mid | num | 用户mid | | +| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | +| mtime | num | 成为粉丝时间 | 时间戳
互关后刷新 | +| tag | null | | | +| special | num | 0 | | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | + +`list`中的对象中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1：无
0：个人认证
1：机构认证 | +| desc | str | 用户认证信息 | 无为空 | + +`list`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0：无
1：有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| themeType | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | 作用尚不明确 | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ------------ | +| path | str | 空 | 作用尚不明确 | + +**示例：** + +获取用户`mid=293793435`的粉丝明细 + +```shell +curl -G 'https://api.bilibili.com/x/relation/followers' \ +--data-urlencode 'vmid=293793435' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询用户关注明细
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [{ + "mid": 387195656, + "attribute": 0, + "mtime": 1583839793, + "tag": null, + "special": 0, + "uname": "L_E_M_O_H_E", + "face": "https://i1.hdslb.com/bfs/face/8ec537db75eeb292faa8dc85a9ff8aba83148c86.jpg", + "sign": "暂时断更。。Back later", + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 0, + "vipDueDate": 0, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }, { + "mid": 175989424, + "attribute": 0, + "mtime": 1583822019, + "tag": null, + "special": 0, + "uname": "哥本哈根iii", + "face": "https://i1.hdslb.com/bfs/face/e53c0fe9315176d48bd294b1f381f0da70131cd7.jpg", + "sign": "", + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 0, + "vipDueDate": 0, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }], + "re_version": 3857745402, + "total": 365 + } +} +``` + +
+
+> https://api.bilibili.com/x/relation/followings
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+登录可看自己全部，其他用户仅可查看前5页
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| vmid | num | 目标用户mid | 必要 | |
+| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空按照最常访问排列：attention | +| ps | num | 每页项数 | 非必要 | 默认为50 | +| pn | num | 页码 | 非必要 | 默认为1
其他用户仅可查看前5页 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页
22115：用户已设置隐私，无法查看 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ------------ | +| list | array | 明细列表 | | +| re_version | num | ？？？ | 作用尚不明确 | +| total | num | 关注总数 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---------------- | +| 0 | obj | 关注1 | | +| n | obj | 关注(n+1) | 按照关注顺序排列 | +| …… | obj | …… | …… | + +数组`list`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---------------------------------------- | ------------ | --------------------------------------- | +| mid | num | 用户mid | | +| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | +| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | + +数组`list`中的对象中的`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组(n+1)的分组id | | +| …… | num | …… | …… | + +`list`中的对象中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1：无
1：认证 | +| desc | str | 用户认证信息 | 无为空 | + +`list`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0：无
1：有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| themeType | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | 作用尚不明确 | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ------------ | +| path | str | 空 | 作用尚不明确 | + +**示例：** + +获取用户`mid=293793435`的关注明细，按照关注顺序 + +```shell +curl -G 'https://api.bilibili.com/x/relation/followings' \ +--data-urlencode 'vmid=293793435' \ +--data-urlencode 'order_type=' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询用户关注明细2
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [{ + "mid": 14082, + "attribute": 2, + "mtime": 1584271945, + "tag": null, + "special": 0, + "uname": "山新", + "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg", + "sign": "都说了是天依爹地，不是妈咪。\r私信有点多回复不过来～商业合作啥的请移步Weibo私信@山新 哦哦哦～", + "official_verify": { + "type": 0, + "desc": "配音演员、声优。洛天依声源提供者。" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1601654400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }, { + "mid": 420831218, + "attribute": 2, + "mtime": 1584208169, + "tag": [207542], + "special": 0, + "uname": "支付宝Alipay", + "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", + "sign": "阿支来了，关注点赞转发投币四连走起！", + "official_verify": { + "type": 1, + "desc": "支付宝官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1585065600000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }], + "re_version": 3228575555, + "total": 699 + } +} +``` + +
+
+> https://app.biliapi.net/x/v2/relation/followings
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+登录可看自己全部，其他用户仅可查看前5页，可以获取已设置可见性隐私的关注列表
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| vmid | num | 目标用户mid | 必要 | |
+| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空按照最常访问排列：attention | +| ps | num | 每页项数 | 非必要 | 默认为50 | +| pn | num | 页码 | 非必要 | 默认为1
其他用户仅可查看前5页 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ------------ | +| list | array | 明细列表 | | +| re_version | num | ？？？ | 作用尚不明确 | +| total | num | 关注总数 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---------------- | +| 0 | obj | 关注1 | | +| n | obj | 关注(n+1) | 按照关注顺序排列 | +| …… | obj | …… | …… | + +数组`list`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---------------------------------------- | ------------ | --------------------------------------- | +| mid | num | 用户mid | | +| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | +| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | + +数组`list`中的对象中的`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组(n+1)的分组id | | +| …… | num | …… | …… | + +`list`中的对象中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1：无
1：认证 | +| desc | str | 用户认证信息 | 无为空 | + +`list`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0：无
1：有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| themeType | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | 作用尚不明确 | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ------------ | +| path | str | 空 | 作用尚不明确 | + +**示例：** + +获取用户`mid=293793435`的关注明细，按照关注顺序 + +```shell +curl -G 'https://app.biliapi.net/x/v2/relation/followings' \ +--data-urlencode 'vmid=293793435' \ +--data-urlencode 'order_type=' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 搜索关注明细
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [{ + "mid": 14082, + "attribute": 2, + "mtime": 1584271945, + "tag": null, + "special": 0, + "uname": "山新", + "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg", + "sign": "都说了是天依爹地，不是妈咪。\r私信有点多回复不过来～商业合作啥的请移步Weibo私信@山新 哦哦哦～", + "official_verify": { + "type": 0, + "desc": "配音演员、声优。洛天依声源提供者。" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1601654400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }, { + "mid": 420831218, + "attribute": 2, + "mtime": 1584208169, + "tag": [207542], + "special": 0, + "uname": "支付宝Alipay", + "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", + "sign": "阿支来了，关注点赞转发投币四连走起！", + "official_verify": { + "type": 1, + "desc": "支付宝官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1585065600000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }], + "re_version": 3228575555, + "total": 699 + } +} +``` + +
+
+> https://api.bilibili.com/x/relation/followings/search
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | -------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| vmid | str | 目标用户mid | 必要 | |
+| name | str | 搜索关键词 | 必要 | |
+| ps | num | 每页项数 | 非必要 | 默认为50 |
+| pn | num | 页码 | 非必要 | 默认为1 |
+
+data 对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ----- | -------- | ------------ |
+| list | array | 明细列表 | |
+| re_version | num | ？？？ | 作用尚不明确 |
+| total | num | 关注总数 | |
+
+`data`中的`list`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ------------- | ---------------- |
+| 0 | obj | 共同关注1 | |
+| n | obj | 共同关注(n+1) | 按照关注顺序排列 |
+| …… | obj | …… | …… |
+
+数组`list`中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
+| mid | num | 用户mid | |
+| attribute | num | 关注属性 | 0：未关注2：已关注
6：已互粉 | +| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | + +数组`list`中的对象中的`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组(n+1)的分组id | | +| …… | num | …… | …… | + +`list`中的对象中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1：无
1：认证 | +| desc | str | 用户认证信息 | 无为空 | + +`list`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0：无
1：有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| themeType | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | 作用尚不明确 | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ------------ | +| path | str | 空 | 作用尚不明确 | + +**示例：** + +搜索我的关注列表中关键词`warma` + +```shell +curl -G 'https://api.bilibili.com/x/relation/followings/search' \ +--data-urlencode 'vmid=293793435' \ +--data-urlencode 'name=warma' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询共同关注明细
+
+查看响应示例：
+ + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 53456, + "attribute": 2, + "mtime": 1586415053, + "tag": [ + -10 + ], + "special": 1, + "uname": "Warma", + "face": "https://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg", + "sign": "我是沃玛，做点傻开心的视频。日常发在微博：@_warma_ ", + "official_verify": { + "type": 0, + "desc": "bilibili 知名UP主" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1637424000000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + } + ], + "total": 1 + } +} +``` + +
+
+> https://api.bilibili.com/x/relation/same/followings
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | -------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| vmid | num | 目标用户mid | 必要 | |
+| ps | num | 每页项数 | 非必要 | 默认为50 |
+| pn | num | 页码 | 非必要 | 默认为1 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功-101：账号未登录
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ------------ | +| list | array | 明细列表 | | +| re_version | num | ？？？ | 作用尚不明确 | +| total | num | 关注总数 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---------------- | +| 0 | obj | 共同关注1 | | +| n | obj | 共同关注(n+1) | 按照关注顺序排列 | +| …… | obj | …… | …… | + +数组`list`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ------------------------------------------- | ------------ | --------------------------------------- | +| mid | num | 用户mid | | +| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | +| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | + +数组`list`中的对象中的`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组(n+1)的分组id | | +| …… | num | …… | …… | + +`list`中的对象中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1：无
1：认证 | +| desc | str | 用户认证信息 | 无为空 | + +`list`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0：无
1：有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| themeType | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | 作用尚不明确 | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ------------ | +| path | str | 空 | 作用尚不明确 | + +**示例：** + +获取自己与用户`mid=2`的共同关注明细 + +```shell +curl -G 'https://api.bilibili.com/x/relation/same/followings' \ +--data-urlencode 'vmid=2' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询悄悄关注明细
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 116683, + "attribute": 2, + "mtime": 1564627532, + "tag": null, + "special": 0, + "uname": "=咬人猫=", + "face": "https://i0.hdslb.com/bfs/face/8fad84a4470f3d894d8f0dc95555ab8f2cb10a83.jpg", + "sign": "面瘫女仆酱~小粗腿~事业线什么的！！吐槽你就输了！喵~", + "official_verify": { + "type": 0, + "desc": "bilibili 2019百大UP主、高能联盟成员" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1618934400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }, + { + "mid": 517717593, + "attribute": 2, + "mtime": 1592126052, + "tag": [ + 207542 + ], + "special": 0, + "uname": "上海爱丽丝幻乐团", + "face": "https://i0.hdslb.com/bfs/face/851a9191cbe93e66304d7577c0f6f83834e52109.jpg", + "sign": "日本同人社团 上海爱丽丝幻乐团", + "official_verify": { + "type": 0, + "desc": "上海爱丽丝幻乐团官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1593792000000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + } + ], + "re_version": 2498273968, + "total": 38 + } +} +``` + +
+
+> https://api.bilibili.com/x/relation/whispers
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | -------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| ps | num | 每页项数 | 非必要 | 默认为50 |
+| pn | num | 页码 | 非必要 | 默认为1 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功-101：账号未登录
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ------------ | +| list | array | 明细列表 | | +| re_version | num | ？？？ | 作用尚不明确 | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---------------- | +| 0 | obj | 关注1 | | +| n | obj | 关注(n+1) | 按照关注顺序排列 | +| …… | obj | …… | …… | + +数组`list`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ------------------------------------------- | ------------ | --------------------------------------- | +| mid | num | 用户mid | | +| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | +| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | + +数组`list`中的对象中的`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组(n+1)的分组id | | +| …… | num | …… | …… | + +`list`中的对象中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1：无
1：认证 | +| desc | str | 用户认证信息 | 无为空 | + +`list`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0：无
1：有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| themeType | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | 作用尚不明确 | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ------------ | +| path | str | 空 | 作用尚不明确 | + +**示例：** + +获取悄悄关注明细 + +```shell +curl -G 'https://api.bilibili.com/x/relation/whispers' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询互相关注明细
+
+查看响应示例：
+ + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 178429408, + "attribute": 1, + "mtime": 1605972105, + "tag": null, + "special": 0, + "uname": "老弟一号", + "face": "https://i2.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg", + "sign": "萌新硬件玩家，前垃圾佬～(◦˙▽˙◦某宝店 老弟一号 粉丝群679540094商务合作V13869651328", + "official_verify": { + "type": 0, + "desc": "知识领域优质UP主" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1632499200000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + } + ], + "re_version": 2137574562 + } +} +``` + +
+
+> https://api.bilibili.com/x/relation/friends
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+查询与自己互关的用户明细，可看全部
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | -------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功-101：账号未登录
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ------------ | +| list | array | 明细列表 | | +| re_version | num | ？？？ | 作用尚不明确 | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---------------- | +| 0 | obj | 互关1 | | +| n | obj | 互关(n+1) | 按照关注顺序排列 | +| …… | obj | …… | …… | + +数组`list`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ------------------------------------------- | ------------ | --------------------------------------- | +| mid | num | 用户mid | | +| attribute | num | 关注属性 | 6：已互粉 | +| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | + +数组`list`中的对象中的`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组(n+1)的分组id | | +| …… | num | …… | …… | + +`list`中的对象中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1：无
1：认证 | +| desc | str | 用户认证信息 | 无为空 | + +`list`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0：无
1：有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| themeType | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | 作用尚不明确 | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ------------ | +| path | str | 空 | 作用尚不明确 | + +**示例：** + +获取互相关注明细 + +```shell +curl -G 'https://api.bilibili.com/x/relation/friends' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询黑名单明细
+
+> https://api.bilibili.com/x/relation/blacks
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | -------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| ps | num | 每页项数 | 非必要 | 默认为50 |
+| pn | num | 页码 | 非必要 | 默认为1 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 293793435, + "attribute": 6, + "mtime": 1583817598, + "tag": [-10], + "special": 1, + "uname": "社会易姐QwQ", + "face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", + "sign": "BAC项目负责人 | 带砖技术宅 | MC 编程 电子 | 车万众\u0026术术人 | 粉丝群1136462265 博客shakaianee.top", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1675872000000, + "dueRemark": "", + "accessStatus" :0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "avatar_subscript_url": "" + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "" + } + ], + "re_version": 0 + } +} +``` + +-101：账号未登录
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | ------------ | ------------ | +| list | array | 明细列表 | | +| re_version | num | ？？？ | 作用尚不明确 | +| total | num | 黑名单总计数 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---------------- | +| 0 | obj | 关注1 | | +| n | obj | 关注(n+1) | 按照关注顺序排列 | +| …… | obj | …… | …… | + +数组`list`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | ------------ | ---------------------- | +| mid | num | 用户mid | | +| attribute | num | 关注属性 | 128：已拉黑 | +| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | +| tag | null | | | +| special | num | 0 | | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | + +`list`中的对象中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1：无
1：认证 | +| desc | str | 用户认证信息 | 无为空 | + +`list`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0：无
1：有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| themeType | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | 作用尚不明确 | + +`vip`中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ------------ | +| path | str | 空 | 作用尚不明确 | + +**示例：** + +获取黑名单明细 + +```shell +curl -G 'https://api.bilibili.com/x/relation/blacks' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 操作用户关系
+
+查看响应示例：
+ + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "mid": 22179720, + "attribute": 128, + "mtime": 1603032789, + "tag": null, + "special": 0, + "uname": "咩2016", + "face": "https://i0.hdslb.com/bfs/face/41fe435a7e62eae605a5908652f32f3afff2ae74.jpg", + "sign": "", + "official_verify": { + "type": 0, + "desc": "" + }, + "vip": { + "vipType": 0, + "vipDueDate": 0, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }, + { + "mid": 16174624, + "attribute": 128, + "mtime": 1603026420, + "tag": null, + "special": 0, + "uname": "其实死亡没有那么痛", + "face": "https://i2.hdslb.com/bfs/face/79257f5a2e7194a71337ccca5927afba7706d316.jpg", + "sign": "等我，我马上就来", + "official_verify": { + "type": 0, + "desc": "" + }, + "vip": { + "vipType": 0, + "vipDueDate": 0, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + } + ], + "re_version": 897205356, + "total": 2 + } +} +``` + +
+
+> https://api.bilibili.com/x/relation/modify
+
+*请求方式：POST*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**正文参数( application/x-www-form-urlencoded )：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ---------------------- | -------------- | -------------------------------------------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| fid | num | 目标用户mid | 必要 | |
+| act | num | 操作代码 | 必要 | **操作代码见下表** |
+| re_src | num | 关注来源代码 | 必要 | 空间：11视频：14
文章：115
活动页面：222 | +| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | + +操作代码`act`： + +| 代码 | 含义 | +| ---- | ------------ | +| 1 | 关注 | +| 2 | 取关 | +| 3 | 悄悄关注 | +| 4 | 取消悄悄关注 | +| 5 | 拉黑 | +| 6 | 取消拉黑 | +| 7 | 踢出粉丝 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
22001：不能对自己进行此操作
22003：用户位于黑名单 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +关注`mid=14082`的用户 + +```shell +curl 'https://api.bilibili.com/x/relation/modify' \ +--data-urlencode 'fid=14082' \ +--data-urlencode 'act=1' \ +--data-urlencode 're_src=11' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 批量操作用户关系
+
+> https://api.bilibili.com/x/relation/batch/modify
+
+*请求方式：POST*
+
+认证方式：Cookie(SESSDATA)或APP
+
+此接口只支持关注和拉黑操作
+
+**正文参数( application/x-www-form-urlencoded )：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ---------------------- | -------------- | ---------------------------------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
+| act | num | 操作代码 | 必要 | 同上查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +仅可为1或5，故只能进行批量关注和拉黑 | +| re_src | num | 关注来源代码 | 必要 | 同上 | +| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
22003：用户位于黑名单 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 数据本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ----- | ------------- | ---- | +| failed_fids | array | 操作失败的mid | | + +`data`中的`failed_fids`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------------ | ---- | +| 0 | num | 操作失败的mid 1 | | +| n | num | 操作失败的mid(n+1) | | +| …… | num | …… | …… | + +**示例：** + +批量关注`mid=1,2,3,4,5`的用户 + +```shell +curl 'https://api.bilibili.com/x/relation/batch/modify' \ +--data-urlencode 'fid=1,2,3,4,5' \ +--data-urlencode 'act=1' \ +--data-urlencode 're_src=11' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询用户与自己关系_仅查关注
+
+> https://api.bilibili.com/x/relation
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| fid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "failed_fids": [] + } +} +``` + +-101：账号未登录
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---------------------------------------- | ------------ | --------------------------------------- | +| mid | num | 目标用户mid | | +| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉
128：拉黑 | +| mtime | num | 关注对方时间 | 时间戳
未关注为0 | +| tag | null默认分组
array存在至少一个分组 | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | + +`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------------------- | ---- | +| 0 | num | 位于分组1的分组 | | +| n | num | 位于分组(n+1)的分组 | | +| …… | num | …… | …… | + +**示例：** + +可得对于`mid=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于为`-10`分组中 + +```shell +curl -G 'https://api.bilibili.com/x/relation' \ +--data-urlencode 'fid=258150656' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 查询用户与自己关系_互相
+
+> https://api.bilibili.com/x/space/acc/relation
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 258150656, + "attribute": 2, + "mtime": 1540659101, + "tag": [-10], + "special": 1 + } +} +``` + +-101：账号未登录
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ------------------------ | ---- | +| relation | obj | 目标用户对于本用户的属性 | | +| be_relation | obj | 本用户对于目标用户的属性 | | + +`data`中的`relation`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---------------------------------------- | ------------ | -------------- | +| mid | num | 对方用户mid | | +| attribute | num | 关注属性 | 0：未关注
1：悄悄关注
2：已关注
6：已互粉
128：拉黑 | +| mtime | num | 关注对方时间 | 互关后刷新时间 | +| tag | null默认分组
array存在至少一个分组 | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | + +`data`中的`be_relation`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---------------------------------------- | ------------ | -------------- | +| mid | num | 自己的mid | | +| attribute | num | 关注属性 | 0：未关注
1：悄悄关注
2：已关注
6：已互粉
128：拉黑 | +| mtime | num | 成为粉丝时间 | 互关后刷新时间 | +| tag | null默认分组
array存在至少一个分组 | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | + +`be_relation`与`relation`中的`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组(n+1)的分组id | | +| …… | num | …… | …… | + +**示例：** + +可得对于`mid=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于为`-10`和`56502`的分组中(虽然我看不到) + +```shell +curl -G 'https://api.bilibili.com/x/space/acc/relation' \ +--data-urlencode 'mid=15858903' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 批量查询用户与自己关系
+
+> https://api.bilibili.com/x/relation/relations
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "relation": { + "mid": 15858903, + "attribute": 6, + "mtime": 1548311059, + "tag": [-10, 194110], + "special": 1, + "is_followed": false + }, + "be_relation": { + "mid": 293793435, + "attribute": 6, + "mtime": 1548311059, + "tag": [56502, -10], + "special": 1, + "is_followed": false + } + } +} +``` + +-101：账号未登录
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | ---------- | ---- | +| {用户mid} | obj | 关注的用户 | 下同 | +| …… | obj | …… | | + +`{用户mid}`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | --------------------------------------- | ------------ | ------------------------------------------------------------ | +| mid | num | 目标用户mid | | +| attribute | num | 关注属性 | 0：未关注
1：悄悄关注
2：已关注
6：已互粉
128：拉黑 | +| mtime | num | 关注对方时间 | 时间戳
未关注为0 | +| tag | null默认分组
array存在至少一个分组 | 分组id | | +| special | num | 特别关注标志 | 0：否
1：是 | + +`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组(n+1)的分组id | | +| …… | num | …… | …… | + +**示例：** + +批量查询`mid=1,2,3,4,5`的关系 + +```shell +curl -G 'https://api.bilibili.com/x/relation/relations' \ +--data-urlencode 'fid=258150656' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 关注分组相关
+
+### 查询关注分组列表
+
+> https://api.bilibili.com/x/relation/tags
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ------ | -------- | ----------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "1": { + "mid": 1, + "attribute": 2, + "mtime": 1601654227, + "tag": null, + "special": 0 + }, + "2": { + "mid": 2, + "attribute": 2, + "mtime": 1601654225, + "tag": null, + "special": 0 + } + } +} +``` + +-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 分组列表 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ---- | +| 0 | obj | 特别关注分组 | | +| 1 | obj | 默认分组 | | +| n | obj | 其他分组 | | +| …… | num | …… | …… | + +数组`data`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ---------- | ---------------------------------- | +| tagid | num | 分组id | 特别关注恒为-10
默认分组恒为0 | +| name | str | 分组名称 | | +| count | num | 分组成员数 | | + +**示例：** + +查询所有的分组的名字以及id + +```shell +curl 'https://api.bilibili.com/x/relation/tags' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 查询关注分组明细
+
+> https://api.bilibili.com/x/relation/tag
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| tagid | num | 分组id | 必要 | 特别关注恒为-10查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [{ + "tagid": -10, + "name": "特别关注", + "count": 16 + }, { + "tagid": 0, + "name": "默认分组", + "count": 536 + },{ + "tagid": 194111, + "name": "我的同学", + "count": 16 + }, + ………… + ] +} +``` + +默认分组恒为0 | +| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空
按照最常访问排列：attention | +| ps | num | 每页项数 | 非必要 | 默认为50 | +| pn | num | 页数 | 非必要 | 默认为1 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ------ | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
22104：该分组不存在 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 成员列表 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---------------- | +| 0 | obj | 成员信息1 | | +| n | obj | 成员信息(n+1) | 按照添加顺序排序 | +| …… | obj | …… | …… | + +数组`data`中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | ----------- | ---- | +| mid | num | 用户mid | | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | + +数组`data`中的对象中的`official_verify`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ------------------- | +| type | num | 用户认证类型 | -1：无
1：认证 | +| desc | str | 用户认证信息 | 无为空 | + +数组`data`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------- | +| vipType | num | 大会员类型 | 0：无
1：月会员
2：年会员 | +| vipDueDate | num | 会员到期时间 | 毫秒 时间戳 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0无
1有 | +| vipStatusWarn | str | 空 | 作用尚不明确 | +| themeType | num | 0 | 作用尚不明确 | +| label | obj | ？？？ | 作用尚不明确 | + +数组`data`中的对象中的`label`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ---- | ------------ | +| path | str | 空 | 作用尚不明确 | + +**示例：** + +以每页2项的方式获取了id为`207542`分组的第1页的粉丝明细，按照关注顺序 + +```shell +curl -G 'https://api.bilibili.com/x/relation/tag' \ +--data-urlencode 'tagid=207542' \ +--data-urlencode 'order_type=' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 查询目标用户所在的分组
+
+> https://api.bilibili.com/x/relation/tag/user
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| fid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [{ + "mid": 420831218, + "uname": "支付宝Alipay", + "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg", + "sign": "阿支来了，关注点赞转发投币四连走起！", + "official_verify": { + "type": 1, + "desc": "支付宝官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1585065600000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }, { + "mid": 125086406, + "uname": "MSI微星科技", + "face": "https://i1.hdslb.com/bfs/face/a844760e4e491677615b39399bc761e74c579bb4.jpg", + "sign": "你好，这里是微星显卡官方！专注显卡三十年，欢迎私信咨询或提问MSI", + "official_verify": { + "type": 1, + "desc": "微星科技官方账号" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1540656000000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "" + } + } + }] +} +``` + +-101：账号未登录
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------------- | ---- | --------- | ---- | +| {加入的分组id 1} | str | 分组1名称 | | +| {加入的分组id n} | str | 分组n名称 | | +| …… | str | …… | | + +**示例：** + +查询用户`mid=319214221`存在的所有分组和名称 + +```shell +curl -G 'https://api.bilibili.com/x/relation/tag/user' \ +--data-urlencode 'fid=319214221' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 查询所有特别关注的mid
+
+> https://api.bilibili.com/x/relation/tag/special
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----- | -------- | ----------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "-10": "特别关注", + "194111": "我的同学" + } +} +``` + +-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 成员列表 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ---- | +| 0 | num | 成员1mid | | +| n | num | 成员(n+1)mid | | +| …… | num | …… | …… | + +**示例：** + +```shell +curl 'https://api.bilibili.com/x/relation/tag/special' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 创建分组
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + 500716647, + 32832243, + 53456, + 25944552, + 301839556, + 427494870, + 319214221, + 31949159, + 382666849, + 258318451, + 15858903, + 54992199, + 3379951, + 392279807, + 23215368, + 258150656, + 20165629, + 22179720 + ] +} +``` + +
+
+> https://api.bilibili.com/x/relation/tag/create
+
+*请求方式：POST*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**正文参数( application/x-www-form-urlencoded )：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ---------------------- | -------------- | ---------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| tag | str | 分组名 | 必要 | 最长16字符 |
+| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功-111：csrf校验失败
-101：账号未登录
-400：请求错误
22106：该分组已经存在
22103：分组名过长 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | -------------- | ---- | +| tagid | num | 创建的分组的id | | + +**示例：** + +创建了名为`测试`的分组，得到id为`216677` + +```shell +curl 'https://api.bilibili.com/x/relation/tag/create' \ +--data-urlencode 'tag=测试' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 重命名分组
+
+> https://api.bilibili.com/x/relation/tag/update
+
+*请求方式：POST*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**正文参数( application/x-www-form-urlencoded )：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ---------------------- | -------------- | ---------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| tagid | num | 分组id | 必要 | |
+| name | str | 新名称 | 必要 | 最长16字符 |
+| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "tagid": 216677 + } +} +``` + +-111：csrf校验失败
-101：账号未登录
-400：请求错误
22103：分组名过长
22104：该分组不存在 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +把id为`194112`的分组更名为`膜法师` + +```shell +curl 'https://api.bilibili.com/x/relation/tag/update' \ +--data-urlencode 'tagid=194112' \ +--data-urlencode 'name=膜法师' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 删除分组
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +
+
+> https://api.bilibili.com/x/relation/tag/del
+
+*请求方式：POST*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**正文参数( application/x-www-form-urlencoded )：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ---------------------- | -------------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| tagid | num | 分组id | 必要 | |
+| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功-111：csrf校验失败
-101：账号未登录
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +示例： + +删除分组id为`216699`的分组 + +```shell +curl 'https://api.bilibili.com/x/relation/tag/del' \ +--data-urlencode 'tagid=216699' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 修改分组成员
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +
+
+> https://api.bilibili.com/x/relation/tags/addUsers
+
+*请求方式：POST*
+
+认证方式：Cookie(SESSDATA)或APP
+
+如需删除分组中的成员，请将`tagids`设为0，即移动至默认分组，而不是取关
+
+**正文参数( application/x-www-form-urlencoded )：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------------------ | -------------- | ------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
+| tagids | nums | 分组id | 必要 | 每个之间用`,`间隔 |
+| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +把关注用户`mid=205631797`同时添加分组关系到id为`-10`和`207542`的分组中 + +```shell +curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ +--data-urlencode 'fids=205631797' \ +--data-urlencode 'tagids=-10,207542' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 复制关注到分组
+
+> https://api.bilibili.com/x/relation/tags/copyUsers
+
+*请求方式：POST*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**正文参数( application/x-www-form-urlencoded )：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------------------ | -------------- | ------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| fids | nums | 待复制的用户mid | 必要 | 每个之间用`,`间隔 |
+| tagids | nums | 目标分组id | 必要 | 每个之间用`,`间隔 |
+| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +把关注用户`mid=4856007`和`mid=326499679`同时复制到为`231305`的分组id中 + +```shell +curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ +--data-urlencode 'fids=4856007,326499679' \ +--data-urlencode 'tagids=231305' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 移动关注到分组
+
+> https://api.bilibili.com/x/relation/tags/moveUsers
+
+*请求方式：POST*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**正文参数( application/x-www-form-urlencoded )：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------------ | ---- | ------------------------ | -------------- | ------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| beforeTagids | nums | 原分组id | 必要 | 每个之间用`,`间隔 |
+| afterTagids | nums | 新分组id | 必要 | 每个之间用`,`间隔 |
+| fids | nums | 待移动的用户mid | 必要 | 每个之间用`,`间隔 |
+| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code":0, + "message":"0", + "ttl":1 +} +``` + +-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +把关注用户`mid=321173469`和`mid=327086920`同时从id为`207542`的分组移动到为`231305`的分组中 + +```shell +curl 'https://api.bilibili.com/x/relation/tags/moveUsers' \ +--data-urlencode 'beforeTagids=207542' \ +--data-urlencode 'afterTagids=23130' \ +--data-urlencode 'fids=321173469,327086920' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
diff --git a/docs/user/space.md b/docs/user/space.md
new file mode 100644
index 0000000000..4b2a683c11
--- /dev/null
+++ b/docs/user/space.md
@@ -0,0 +1,4832 @@
+# 用户空间相关
+
+- [主页](#主页)
+ - [置顶视频](#置顶视频)
+ - [查询用户置顶视频](#查询用户置顶视频)
+ - [设置置顶视频](#设置置顶视频)
+ - [取消置顶视频](#取消置顶视频)
+ - [代表作视频](#代表作视频)
+ - [查询用户代表作视频列表](#查询用户代表作视频列表)
+ - [添加代表作视频](#添加代表作视频)
+ - [删除代表作视频](#删除代表作视频)
+ - [个人TAG](#个人TAG)
+ - [查看用户个人TAG](#查看用户个人TAG)
+ - [修改个人TAG](#修改个人TAG)
+ - [空间公告](#空间公告)
+ - [查看用户空间公告](#查看用户空间公告)
+ - [修改空间公告](#修改空间公告)
+ - [主页板块布局与权限](#主页板块布局与权限)
+ - [查询空间设置](#查询空间设置)
+ - [调整空间板块布局](#调整空间板块布局)
+ - [修改空间隐私权限](#修改空间隐私权限)
+ - [查询用户最近玩过的游戏](#查询用户最近玩过的游戏)
+ - [获取用户最近投币的视频明细](#获取用户最近投币的视频明细)
+ - [获取用户最近点赞的视频明细](#获取用户最近点赞的视频明细)
+- [投稿](#投稿)
+ - [查询用户投稿视频明细](#查询用户投稿视频明细)
+ - [查询用户投稿相簿预览](#查询用户投稿相簿预览)
+ - [查询用户投稿相簿明细](#查询用户投稿相簿明细)
+- [频道](#频道)
+ - [查询用户频道列表](#查询用户频道列表)
+ - [查询用户频道中的视频](#查询用户频道中的视频)
+ - [创建频道](#创建频道)
+ - [修改频道](#修改频道)
+ - [删除频道](#删除频道)
+ - [频道添加视频](#频道添加视频)
+ - [频道删除视频](#频道删除视频)
+ - [调整频道视频排序](#调整频道视频排序)
+ - [检查频道中有无失效视频](#检查频道中有无失效视频)
+- [收藏](#收藏)
+ - [查询用户创建的视频收藏夹](#查询用户创建的视频收藏夹)
+ - [查询用户收藏的视频收藏夹](#查询用户收藏的视频收藏夹)
+- [课程](#课程)
+ - [查询用户发布的课程列表](#查询用户发布的课程列表)
+- [订阅](#订阅)
+ - [查询用户追番预览列表](#查询用户追番预览列表)
+ - [查询用户追番（追剧）明细](#查询用户追番（追剧）明细)
+ - [查询用户关注的TAG（话题）](#查询用户关注的TAG话题)
+
+---
+
+## 主页
+
+查看响应示例：
+ +```json +{ + "code":0, + "message":"0", + "ttl":1 +} +``` + +
+
+### 置顶视频
+
+#### 查询用户置顶视频
+
+>https://api.bilibili.com/x/space/top/arc
+
+*请求方式：GET*
+
+粉丝在其主页上可见
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------|-----|---------|-----|-----|
+| vmid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|---------------------------------------|
+| code | num | 返回值 | 0：成功-400：请求错误
53016：没有置顶视频 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------------|------|-----------------|-------------------------------------------------------------------| +| aid | num | 稿件avid | | +| videos | num | 视频分P总数 | 默认为1 | +| tid | num | 分区tid | | +| tname | str | 子分区名称 | | +| copyright | num | 是否转载 | 1：原创
2：转载 | +| pic | str | 视频封面图片url | | +| title | str | 稿件标题 | | +| pubdate | num | 稿件发布时间 | 时间戳 | +| ctime | num | 用户提交稿件的时间 | 时间戳 | +| desc | str | 视频简介 | | +| state | num | 视频状态 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`state`备注 | +| attribute | num | 稿件属性位配置 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`attribute`备注 | +| duration | num | 视频总计持续时长（所有分P） | 单位为秒 | +| rights | obj | 视频属性标志 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`rights`对象 | +| owner | obj | 视频UP主信息 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`owner`对象 | +| stat | obj | 视频状态数 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`stat`对象 | +| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 | +| cid | num | 视频1P cid | | +| dimension | obj | 视频1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 | +| bvid | str | 稿件bvid | | +| reason | str | 置顶视频备注 | | +| inter_video | bool | 是否为合作视频 | false：否
true：是 | + +**示例：** + +查询用户`mid=23215368`的置顶视频 + +```shell +curl -G 'https://api.bilibili.com/x/space/top/arc' \ +--data-urlencode 'vmid=23215368' +``` + +
+
+
+#### 设置置顶视频
+
+> https://api.bilibili.com/x/space/top/arc/set
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|--------|-----|----------------------|--------|----------------------|
+| aid | num | 置顶目标稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 置顶目标稿件bvid | 必要（可选） | avid与bvid任选一个 |
+| reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "aid": 37896701, + "videos": 1, + "tid": 28, + "tname": "原创音乐", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/cc9e72822d68fffdd0406144f1b5348a13c89652.jpg", + "title": "燃烧吧！铃声！把主流手机铃声编成一首曲子", + "pubdate": 1544469671, + "ctime": 1544469671, + "desc": "各品牌的手机铃声大合奏，毫无违和感~", + "state": 0, + "attribute": 16768, + "duration": 208, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0 + }, + "owner": { + "mid": 23215368, + "name": "Wayjon冰冰酱", + "face": "http://i2.hdslb.com/bfs/face/7c9715f1768191137eb7ebf91918ca0f99532012.jpg" + }, + "stat": { + "aid": 37896701, + "view": 1058237, + "danmaku": 16821, + "reply": 3725, + "favorite": 76888, + "coin": 100694, + "share": 17091, + "now_rank": 0, + "his_rank": 0, + "like": 90521, + "dislike": 0 + }, + "dynamic": "#编曲##FL##纯音乐#", + "cid": 66621209, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "bvid": "BV18t411q7zz", + "reason": "", + "inter_video": false + } +} +``` + +默认为空 | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|---------------------------------------------------------------------------------------------------------------------------| +| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-304：未修改
-400：请求错误
53014：稿件已失效
53015：备注过长
53017：置顶非自己的稿件 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +置顶视频`av98948772`/`BV1n741127LD` + +avid方式： + +```shell +curl 'https://api.bilibili.com/x/space/top/arc/set' \ +--data-urlencode 'aid=98948772' \ +-b 'SESSDATA=xxx' +``` + +bvid方式： + +```shell +curl 'https://api.bilibili.com/x/space/top/arc/set' \ +--data-urlencode 'bvid=BV1n741127LD' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+#### 取消置顶视频
+
+> https://api.bilibili.com/x/space/top/arc/cancel
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------|-----|----------------------|-----|-----|
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|--------------------------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-101：账号未登录
-111：csrf校验失败
-400：请求错误（重复取消） | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +```shell +curl 'https://api.bilibili.com/x/space/top/arc/cancel' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 代表作视频
+
+#### 查询用户代表作视频列表
+
+> https://api.bilibili.com/x/space/masterpiece
+
+*请求方式：GET*
+
+新访客在其主页上可见
+
+最多可以设置3个
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------|-----|---------|-----|-----|
+| vmid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-------|-------|---------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 代表作列表 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|------|------------------| +| 0 | obj | 代表作1 | 无则为空 | +| 1 | obj | 代表作2 | 无则为空 | +| 2 | obj | 代表作3 | 无则为空
最多设置3个 | + +`data`数组中的对象： + +同[查询用户置顶视频](#查询用户置顶视频)中的`data`对象 + +**示例：** + +查询用户`mid=23215368`的代表作视频列表 + +```shell +curl -G 'https://api.bilibili.com/x/space/masterpiece' \ +--data-urlencode 'vmid=23215368' +``` + +
+
+
+#### 添加代表作视频
+
+> https://api.bilibili.com/x/space/masterpiece/add
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+代表作上限为3个稿件
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|--------|-----|----------------------|--------|----------------------|
+| aid | num | 置顶目标稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 置顶目标稿件bvid | 必要（可选） | avid与bvid任选一个 |
+| reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [{ + "aid": 37896701, + "videos": 1, + "tid": 28, + "tname": "原创音乐", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/cc9e72822d68fffdd0406144f1b5348a13c89652.jpg", + "title": "燃烧吧！铃声！把主流手机铃声编成一首曲子", + "pubdate": 1544469671, + "ctime": 1544469671, + "desc": "各品牌的手机铃声大合奏，毫无违和感~", + "state": 0, + "attribute": 16768, + "duration": 208, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0 + }, + "owner": { + "mid": 23215368, + "name": "Wayjon冰冰酱", + "face": "http://i2.hdslb.com/bfs/face/7c9715f1768191137eb7ebf91918ca0f99532012.jpg" + }, + "stat": { + "aid": 37896701, + "view": 1058241, + "danmaku": 16821, + "reply": 3725, + "favorite": 76888, + "coin": 100694, + "share": 17091, + "now_rank": 0, + "his_rank": 0, + "like": 90521, + "dislike": 0 + }, + "dynamic": "#编曲##FL##纯音乐#", + "cid": 66621209, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "bvid": "BV18t411q7zz", + "reason": "", + "inter_video": false + }, { + "aid": 39596658, + "videos": 1, + "tid": 21, + "tname": "日常", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/431e51d0e40e3461e1c1b0f59c755ae8843b1adb.jpg", + "title": "MY2018 - 纪念我的2018年", + "pubdate": 1546328392, + "ctime": 1546328392, + "desc": "", + "state": 0, + "attribute": 16768, + "duration": 239, + "mission_id": 10996, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0 + }, + "owner": { + "mid": 23215368, + "name": "Wayjon冰冰酱", + "face": "http://i2.hdslb.com/bfs/face/7c9715f1768191137eb7ebf91918ca0f99532012.jpg" + }, + "stat": { + "aid": 39596658, + "view": 1518, + "danmaku": 16, + "reply": 40, + "favorite": 22, + "coin": 60, + "share": 9, + "now_rank": 0, + "his_rank": 0, + "like": 112, + "dislike": 0 + }, + "dynamic": "#vlog##记录##生活记录#", + "cid": 69561078, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "bvid": "BV1Jt411B7La", + "reason": "", + "inter_video": false + }, { + "aid": 44721369, + "videos": 1, + "tid": 28, + "tname": "原创音乐", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/9887797402599c42f74a7624f3db4a92a0ebf465.jpg", + "title": "【铃声串烧系列】华米两开花；中华有为，国之荣耀！把主流手机铃声编成一首曲子", + "pubdate": 1551128445, + "ctime": 1551128445, + "desc": "把主流手机铃声编成一首曲子，这一版用华为的铃声作为主旋律，毫无违和感~伴随着2019mwc的开幕，希望国产厂商能获得全世界的目光，并且将属于中国人的科技自信传递到全世界！", + "state": 0, + "attribute": 16768, + "duration": 174, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0 + }, + "owner": { + "mid": 23215368, + "name": "Wayjon冰冰酱", + "face": "http://i2.hdslb.com/bfs/face/7c9715f1768191137eb7ebf91918ca0f99532012.jpg" + }, + "stat": { + "aid": 44721369, + "view": 306757, + "danmaku": 7713, + "reply": 1520, + "favorite": 17216, + "coin": 16489, + "share": 2917, + "now_rank": 0, + "his_rank": 0, + "like": 21439, + "dislike": 0 + }, + "dynamic": "#铃声##纯音乐##音乐#【铃声串烧】Mix Ringtones！船新的版本来啦！这一版用华为的铃声作为主旋律，毫无违和感~伴随着2019mwc的开幕，希望国产厂商能获得全世界的目光，并且将属于中国人的科技自信传递到全世界！", + "cid": 78290138, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "bvid": "BV1vb411879C", + "reason": "", + "inter_video": false + }] +} +``` + +默认为空 | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|------------------------------------------------------------------------------------------------------------------------------------------------| +| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
53014：稿件已失效
53015：备注过长
53017：置顶非自己的稿件
53019：达到上限
53020：已经存在该稿件 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +添加视频`av94916552`/`BV1ZE411K7ux`到代表作列表 + +avid方式： + +```shell +curl 'https://api.bilibili.com/x/space/masterpiece/add' \ +--data-urlencode 'aid=94916552' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +bvid方式： + +```shell +curl 'https://api.bilibili.com/x/space/masterpiece/add' \ +--data-urlencode 'bvid=BV1ZE411K7ux' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+#### 删除代表作视频
+
+> https://api.bilibili.com/x/space/masterpiece/cancel
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------|-----|----------------------|--------|---------------|
+| aid | num | 要删除的目标稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 要删除的目标稿件bvid | 必要（可选） | avid与bvid任选一个 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|------------------------------------------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-101：账号未登录
-111：csrf校验失败
-400：请求错误
53021：置顶列表中没有该视频 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | + +**示例：** + +删除置顶视频`av59765630`/`BV1Yt41137T6` + +avid方式： + +```shell +curl 'api.bilibili.com/x/space/masterpiece/cancel' \ +--data-urlencode 'aid=59765630' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +bvid方式： + +```shell +curl 'https://api.bilibili.com/x/space/masterpiece/cancel' \ +--data-urlencode 'bvid=BV1Yt41137T6' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +### 个人TAG + +#### 查看用户个人TAG + +> https://api.bilibili.com/x/space/acc/tags + +*请求方式：GET* + +上限5条，且内容由用户自定义 + +带有转义 + +**url参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +|-----|-----|---------|-----|-----| +| mid | num | 目标用户mid | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-------|------|---------------------| +| code | num | 返回值 | 0：成功
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 信息本体 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|------|---------| +| 0 | obj | 套了个娃 | 只有1项？？？ | + +`data`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|------|-------|---------|-----| +| mid | num | 目标用户mid | | +| tags | array | TAG名称 | | + +`data`数组中的对象中的`tags`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|----------|------| +| 0 | str | TAG1 | | +| n | str | TAG(n+1) | | +| …… | str | …… | | +| 4 | str | TAG5 | 上限5条 | + +**示例：** + +查看用户`mid=53456`的个人TAG + +```shell +curl -G 'https://api.bilibili.com/x/space/acc/tags' \ +--data-urlencode 'mid=53456' +``` + +
+
+
+#### 修改个人TAG
+
+> https://api.bilibili.com/x/space/acc/tags/set
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+鉴权方式：Cookie中`DedeUserID`存在且不为0
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------|------|----------------------|-----|--------------------------------------------------------------------------------|
+| tags | strs | 要设置的TAG内容 | 非必要 | 删除公告留空或省去即可查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + { + "mid": 53456, + "tags": [ + "游戏", + "音乐", + "warma", + "搞笑", + "动画" + ] + } + ] +} +``` + +各TAG长度小于10字符
最多5个TAG
各TAG之间用","(%2C)分隔
重复TAG无效 | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|----------------------------------------------------------------| +| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误（超出长度限制） | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +修改个人TAG为`minecraft,技术宅,大佬,小哥哥,可爱` + +```shell +curl 'https://api.bilibili.com/x/space/acc/tags/set' \ +--data-urlencode 'tags=minecraft,技术宅,大佬,小哥哥,可爱' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx;DedeUserID=1' +``` + +
+
+
+### 空间公告
+
+#### 查看用户空间公告
+
+> https://api.bilibili.com/x/space/notice
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ---- |
+| mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|---------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | str | 公告信息 | 无则为空 | + +**示例：** + +查看用户`mid=53456`的空间公告 + +```shell +curl -G 'https://api.bilibili.com/x/space/notice' \ +--data-urlencode 'mid=53456' +``` + +
+
+
+#### 修改空间公告
+
+> https://api.bilibili.com/x/space/notice/set
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|--------|-----|----------------------|-----|--------------------------|
+| notice | str | 要设置的公告内容 | 非必要 | 删除公告留空或省去即可查看响应示例：
+ +```json +{ + "code":0, + "message":"0", + "ttl":1, + "data":"我的微博 @_warma_\n直播录像上传到：warma养鸽场\n头像画师是：微博@Dr-H_喵_\n横幅画师：@薬屋" +} +``` + +少于150字符 | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|------------------------------------------------------------------------------| +| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-304：未修改
-400：请求错误（超出长度限制） | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | + +**示例：** + +修改个人空间公告为`鸽子` + +```shell +curl 'https://api.bilibili.com/x/space/notice/set' \ +--data-urlencode 'notice=鸽子' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 主页板块布局与权限
+
+#### 查询空间设置
+
+> https://space.bilibili.com/ajax/settings/getSettings
+
+*请求方式：GET*
+
+注：带有转义
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|---------|-----|-----|
+| mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|--------|-------------------------|---------------------------|----------------------|
+| status | bool | 用户是否存在 | true：存在查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +false：不存在 | +| data | 用户存在时：obj
用户不存在时：str | 用户存在时：信息本体
用户不存在时：错误信息 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|------------------------|-------|------------|--------| +| privacy | obj | 空间隐私权限 | | +| index_order | array | 空间板块布局 | | +| theme | str | default主题？ | 作用尚不明确 | +| theme_preview_img_path | str | 主题预览图路径？ | 作用尚不明确 | +| toutu | obj | 空间头图 | | + +`privacy`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------------|-----|---------|------------------------| +| bangumi | num | 追番及追剧 | 0：隐藏
1：公开
**下同** | +| bbq | num | 轻视频 | | +| channel | num | 频道 | | +| coins_video | num | 最近投币的视频 | | +| comic | num | 追漫 | | +| dress_up | num | 装扮 | | +| fav_video | num | 收藏夹 | | +| groups | num | 圈子？ | 作用尚不明确 | +| likes_video | num | 最近点赞的视频 | | +| played_game | num | 最近玩过的游戏 | | +| tags | num | 订阅标签 | | +| user_info | num | 个人资料 | | + +`index_order`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|---------|--------------------------| +| 0 | obj | 板块1 | 根据板块布局顺序排序
先左侧布局后右侧布局 | +| n | obj | 板块(n+1) | | +| …… | obj | …… | …… | + +`index_order`数组内对象： + +| 字段 | 类型 | 内容 | 备注 | +|------|-----|------|-----| +| id | num | 板块编号 | | +| name | str | 板块名称 | | + +`toutu`对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------------|-----|------------|-----------------------------------| +| sid | num | 空间头图ID | | +| expire | num | 到期时间？ | 时间戳？
作用尚不明确 | +| s_img | str | 空间头图小图相对路径 | 完整url为`https://i0.hdslb.com/`+相对路径 | +| l_img | str | 空间头图相对路径 | **同上** | +| android_img | str | 空 | 注：**手机端头图与web端不同，需要用另一个api获取** | +| iphone_img | str | 空 | | +| ipad_img | str | 空 | | +| thumbnail_img | str | 缩略图 | | +| platform | num | 0 | 作用尚不明确 | + +**示例：** + +查看`mid=2`的空间设置 + +```shell +curl -G 'https://space.bilibili.com/ajax/settings/getSettings' \ +--data-urlencode 'mid=2' +``` + +
+
+
+#### 调整空间板块布局
+
+> https://space.bilibili.com/ajax/settings/setIndexOrder
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+鉴权方式：Cookie中`DedeUserID`及`DedeUserID__ckMd5`存在且不为0，referer为 `.bilibili.com`域名下
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-------------|------|----------------------|-----|-----------------------------------------------|
+| index_order | nums | 布局列表 | 必要 | 每个值之间用","（%2C）分隔查看响应示例：
+ +```json +{ + "status":true, + "data":{ + "privacy":{ + "bangumi":1, + "bbq":1, + "channel":1, + "coins_video":0, + "comic":1, + "dress_up":1, + "fav_video":0, + "groups":0, + "likes_video":0, + "played_game":1, + "tags":1, + "user_info":1 + }, + "index_order":[ + { + "id":1, + "name":"我的稿件" + }, + { + "id":8, + "name":"我的专栏" + }, + { + "id":7, + "name":"我的频道" + }, + { + "id":2, + "name":"我的收藏夹" + }, + { + "id":3, + "name":"订阅番剧" + }, + { + "id":4, + "name":"订阅标签" + }, + { + "id":5, + "name":"最近投币的视频" + }, + { + "id":6, + "name":"我的圈子" + }, + { + "id":9, + "name":"我的相簿" + }, + { + "id":21, + "name":"公告" + }, + { + "id":22, + "name":"直播间" + }, + { + "id":23, + "name":"个人资料" + }, + { + "id":24, + "name":"官方活动" + }, + { + "id":25, + "name":"最近玩过的游戏" + } + ], + "theme":"default", + "theme_preview_img_path":"", + "toutu":{ + "sid":1, + "expire":2861874560, + "s_img":"bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png", + "l_img":"bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png", + "android_img":"", + "iphone_img":"", + "ipad_img":"", + "thumbnail_img":"", + "platform":0 + } + } +} +``` + +先左侧布局再右侧布局
值的意义见下表 | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +布局参数`index_order`： + +| 值 | 含义 | +|-----|----------------------| +| 1 | （左侧）我的稿件 | +| 2 | （左侧）我的收藏夹 | +| 3 | （左侧）订阅番剧 | +| 4 | （左侧）订阅标签 | +| 5 | （左侧）最近投币的视频 | +| 6 | （左侧）我的圈子**（此板块被隐藏）** | +| 7 | （左侧）我的频道 | +| 8 | （左侧）我的专栏 | +| 9 | （左侧）我的相簿 | +| 21 | （右侧）公告 | +| 22 | （右侧）直播间 | +| 23 | （右侧）个人资料 | +| 24 | （右侧）官方活动 | +| 25 | （右侧）最近玩的游戏 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|--------|------|------|---------------------------| +| ststus | bool | 操作结果 | true：操作成功
false：操作失败 | +| data | str | 错误信息 | 正确时无此项 | + +**示例：** + +调整空间布局为： + +>我的稿件 直播间 +>我的专栏 个人资料 +>订阅番剧 公告 +>我的收藏夹 官方活动 +>我的相簿 最近玩的游戏 +>最近投币的视频 +>订阅标签 +>我的频道 + +```shell +curl 'https://space.bilibili.com/ajax/settings/setIndexOrder' \ +--data-urlencode 'index_order=1,8,3,2,9,5,4,7,22,23,21,24,25,6' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx;DedeUserID=1;DedeUserID__ckMd5=1;' \ +-e 'https://www.bilibili.com' +``` + +
+
+
+#### 修改空间隐私权限
+
+> https://space.bilibili.com/ajax/settings/setPrivacy
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+鉴权方式：Cookie中`DedeUserID`及`DedeUserID__ckMd5`存在且不为0，referer为 `.bilibili.com`域名下
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-------------|------|----------------------|-----|----------------------------|
+| fav_video | num | 收藏视频 | 非必要 | 0：隐藏查看响应示例：
+ +```json +{ + "status": true +} +``` + +1：公开
**下同** | +| bangumi | num | 追番及追剧 | 非必要 | | +| tags | num | 关注的TAG | 非必要 | | +| coins_video | num | 投币的视频 | 非必要 | | +| user_info | num | 个人信息 | 非必要 | | +| played_game | num | 玩过的游戏 | 非必要 | | +| csrf | nstr | CSRF Token（位于cookie） | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|--------|------|------|---------------------------| +| ststus | bool | 操作结果 | true：操作成功
false：操作失败 | +| data | str | 错误信息 | 正确时无此项 | + +**示例：** + +设置`关注的TAG`为隐藏 + +```shell +curl 'https://space.bilibili.com/ajax/settings/setPrivacy' \ +--data-urlencode 'tags=0' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx;DedeUserID=1;DedeUserID__ckMd5=1;' \ +-e 'https://www.bilibili.com' +``` + +
+
+
+### 查询用户最近玩过的游戏
+
+> https://api.bilibili.com/x/space/lastplaygame
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|---------|-----|-----|
+| mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-------------------------|------|------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "status": true +} +``` + +-400：请求错误
53013：用户隐私设置未公开 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | 隐藏时：null
公开时：array | 信息本体 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|---------|----------| +| 0 | obj | 游戏1 | | +| n | obj | 游戏(n+1) | 项数为总计游戏数 | +| …… | obj | …… | …… | + +`data`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|-----------|-----| +| website | str | 游戏主页链接url | | +| image | str | 游戏图片url | | +| name | str | 游戏名 | | + +**示例：** + +查询`mid=2`的最近玩过的游戏 + +```shell +curl -G 'https://api.bilibili.com/x/space/lastplaygame' \ +--data-urlencode 'mid=2' +``` + +
+
+
+### 获取用户最近投币的视频明细
+
+> https://api.bilibili.com/x/space/coin/video
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+如设置隐私查看自己的需要认证 仅包含最近投币的20个视频，如超过指定时间未投币（也许一个月），列表将为空
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ---- |
+| vmid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-------------------------|------|------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + { + "website": "https://game.bilibili.com/fgo/event_meihosou", + "image": "http://i0.hdslb.com/bfs/game/f7d4ee0877089e4079b8f0b4f5c95dd4ceba512a.png", + "name": "命运-冠位指定（Fate/GO）" + }, + { + "website": "https://game.bilibili.com/pcr/xxtix", + "image": "http://i0.hdslb.com/bfs/game/7922ecea5cc76fe3c8c177e1d4a6c8cf1c36a700.jpg", + "name": "公主连结Re:Dive" + }, + { + "website": "https://game.bilibili.com/dwbgx/", + "image": "http://i0.hdslb.com/bfs/game/6d5b2df70dfa987408d8d09110cdc327949885e3.png", + "name": "大王不高兴" + }, + { + "website": "https://game.bilibili.com/bangdream/1stanniversary-yxzx/", + "image": "http://i0.hdslb.com/bfs/game/4a7d0b7272dffe5a489ee935b6bd2d4f7d5f1257.png", + "name": "BanG Dream！" + }, + { + "website": "http://www.biligame.com/detail/?id=101772", + "image": "http://i0.hdslb.com/bfs/game/8e8b04e7bd2170c2ba2c9f563a62c72bac2eba2c.jpg", + "name": "明日方舟" + } + ] +} +``` + +-400：请求错误
53013：用户隐私设置未公开 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | 隐藏时：null
公开时：array | 信息本体 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|-----------|-----| +| 0 | obj | 投币视频1 | | +| n | obj | 投币视频（n+1） | | +| …… | obj | …… | | + +`data`数组中的对象： + +基本同[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的data对象 + +**示例：** + +查看用户`mid=15858903`的最近投币视频 + +```shell +curl -L -X GET 'https://api.bilibili.com/x/space/coin/video?vmid=15858903' +``` + +
+
+
+### 获取用户最近点赞的视频明细
+
+> https://api.bilibili.com/x/space/like/video
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+如设置隐私查看自己的需要认证 仅包含最近点赞的20个视频，也可能为空
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------|-----|---------|-----|-----|
+| vmid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-------------------------|------|------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [ + { + "aid": 259434557, + "videos": 1, + "tid": 218, + "tname": "喵星人", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/47d46ad72bf1898ebbfe7d82a9d972d4b53e61fc.jpg", + "title": "42度在家造溜冰场降温，猫上去直呼脚滑！", + "pubdate": 1660361400, + "ctime": 1660361407, + "desc": "刚开始真的觉得很难，不可能，学会理论知识后觉得，就这？太简单了，所以随便做做是成立的。就是学费有点贵，1w多……，我现在空调随便修！希望日后修空调能把这钱在挣回来！（溜冰场上期指路：BV1ga411f79y）\n萌宠区手工up主往期发明指路： \n猫力跑步发电机：BV1iy4y1a7Cb \n电动撸毛器：BV1H64y1v7gq\n戒烟头盔：BV1H64y1k7tz \n猫热能暖床器：BV1xF411i7tw \n全透明赏猫床：BV1Qb4y1C7sn \n写不完啦 还有很多，就要靠各位慢慢挖掘啦！", + "state": 0, + "duration": 501, + "mission_id": 859937, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 20951119, + "name": "蒂姆嘟嘟Tim", + "face": "http://i1.hdslb.com/bfs/face/9860c4c559fd2517b1fa92e592d3d71b95bb3ec2.jpg" + }, + "stat": { + "aid": 259434557, + "view": 1403311, + "danmaku": 5762, + "reply": 1295, + "favorite": 26633, + "coin": 100847, + "share": 4502, + "now_rank": 0, + "his_rank": 64, + "like": 130944, + "dislike": 0 + }, + "dynamic": "猫确实会两条腿滑冰！猫和老鼠诚不欺我", + "cid": 800970167, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 3702, + "short_link_v2": "https://b23.tv/BV1wa411Z77n", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220812a228chhkmeci9f0hizo6ivhzv_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1wa411Z77n", + "coins": 2, + "time": 1662182649, + "ip": "", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + } + ] +} +``` + +-400：请求错误
53013：用户隐私设置未公开 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | 隐藏时：null
公开时：array | 信息本体 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|-----------|-----| +| 0 | obj | 点赞视频1 | | +| n | obj | 点赞视频（n+1） | | +| …… | obj | …… | | + +`data`数组中的对象： + +基本同[获取视频详细信息(web端)](/video/info.md#获取视频详细信息(web端))中的data对象 + +**示例：** + +查看用户`mid=15858903`的最近投币视频 + +```shell +curl -L -X GET 'https://api.bilibili.com/x/space/like/video?vmid=15858903' +``` + +
+
+
+## 投稿
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "aid": 53516907, + "videos": 1, + "tid": 26, + "tname": "音MAD", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/3653400bb9a5996c9f0702d20fc431210dca0c5e.jpg", + "title": "喵内我回来了Brain Power", + "pubdate": 1558756227, + "ctime": 1558756227, + "desc": "在准备一个合作，所以一直没更新，O-oooooooooo AAAAE-A-A-I-A-U- JO-oooooooooooo AAE-O-A-A-U-U-A- E-eee-ee-eee AAAAE-A-E-I-E-A- JO-ooo-oo-oo-oo EEEEO-A-AAA-AAAA", + "state": 0, + "duration": 48, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 12466098, + "name": "不知道4576", + "face": "http://i0.hdslb.com/bfs/face/1361b4a2e686e9efa89fc0f1024985d0c44345c6.jpg" + }, + "stat": { + "aid": 53516907, + "view": 125484, + "danmaku": 258, + "reply": 441, + "favorite": 4268, + "coin": 3132, + "share": 859, + "now_rank": 0, + "his_rank": 0, + "like": 5767, + "dislike": 0 + }, + "dynamic": "#BRAIN POWER##音MAD##天使降临到我身边#", + "cid": 93639076, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1V4411s7Qr", + "bvid": "BV1V4411s7Qr", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 557851916, + "videos": 1, + "tid": 122, + "tname": "野生技能协会", + "copyright": 2, + "pic": "http://i1.hdslb.com/bfs/archive/fea0d9efa7e2dc8cd9960bd466f78b2ed84d907d.jpg", + "title": "请问：「宁可在屎山上不断堆代码，也不愿意优化项目需求」❓", + "pubdate": 1662441923, + "ctime": 1662441923, + "desc": "https://fishc.com.cn/thread-217312-1-1.html\n⬆️关于产品迭代的3个关键⬆️", + "state": 0, + "duration": 312, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 0, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 314076440, + "name": "鱼C-小甲鱼", + "face": "http://i2.hdslb.com/bfs/face/4543ce186f9b74e60a85e66c010187bd3be3d0e1.jpg" + }, + "stat": { + "aid": 557851916, + "view": 89834, + "danmaku": 245, + "reply": 164, + "favorite": 490, + "coin": 265, + "share": 570, + "now_rank": 0, + "his_rank": 0, + "like": 1601, + "dislike": 0 + }, + "dynamic": "【遇山开路 逢水搭桥】超完美产品是如何「迭代」出来的❓", + "cid": 825277912, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 4830, + "short_link_v2": "https://b23.tv/BV1pe4y1C7XD", + "up_from_v2": 20, + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220906qn22r4a6hff6vie1bodoftvgi_firsti.jpg", + "pub_location": "广东", + "bvid": "BV1pe4y1C7XD", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 730007618, + "videos": 1, + "tid": 27, + "tname": "综合", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/1f65fd131db7eb81fd270e6ccb7257b68dfd60c4.jpg", + "title": "细！《猫和老鼠》中的小穿帮竟然有这么多！画师偷懒？", + "pubdate": 1661862565, + "ctime": 1661862565, + "desc": "BGM：超级马里奥世界\n 匈牙利狂想曲-李斯特\n Used to-James Carter", + "state": 0, + "duration": 338, + "mission_id": 779615, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 38968617, + "name": "大福咕咕", + "face": "http://i0.hdslb.com/bfs/face/e4a00d5409f1888c10e7382bf15df0fbd9f78ae8.jpg" + }, + "stat": { + "aid": 730007618, + "view": 8052558, + "danmaku": 6994, + "reply": 1905, + "favorite": 181436, + "coin": 113827, + "share": 5447, + "now_rank": 0, + "his_rank": 2, + "like": 698492, + "dislike": 0 + }, + "dynamic": "考虑到广大朋友们要开学了 直接提前更新！", + "cid": 819285197, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 371093, + "short_link_v2": "https://b23.tv/BV1kD4y1672t", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220830a238owa0pg6docs2wak8t6tg2_firsti.jpg", + "pub_location": "北京", + "bvid": "BV1kD4y1672t", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 886537437, + "videos": 2, + "tid": 22, + "tname": "鬼畜调教", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/db9314a8b2730ee95cb9cac7fc5054c770ea9c9f.jpg", + "title": "电棍：向♿奔去(修复版)", + "pubdate": 1612420280, + "ctime": 1612420280, + "desc": "原作@_Karasu_ \n拙劣的模仿 歌词有修改", + "state": 0, + "duration": 448, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 12771348, + "name": "DJRicher", + "face": "http://i0.hdslb.com/bfs/face/4a033640048238cb039add4e064804e227e87082.jpg" + }, + "stat": { + "aid": 886537437, + "view": 8790816, + "danmaku": 11516, + "reply": 50330, + "favorite": 106746, + "coin": 157098, + "share": 66553, + "now_rank": 0, + "his_rank": 0, + "like": 155180, + "dislike": 0 + }, + "dynamic": "", + "cid": 312766707, + "dimension": { + "width": 1280, + "height": 720, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1vK4y1p7F5", + "bvid": "BV1vK4y1p7F5", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 514421957, + "videos": 1, + "tid": 21, + "tname": "日常", + "copyright": 2, + "pic": "http://i2.hdslb.com/bfs/archive/8570e2264c585ec47fa2f90f0fb41fcbe24082c1.jpg", + "title": "女子“巨乳症” 至Q杯，医生切除26斤赘乳", + "pubdate": 1660436958, + "ctime": 1660436958, + "desc": "网络", + "state": 0, + "duration": 157, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 0, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 153362257, + "name": "微胖委员会", + "face": "http://i1.hdslb.com/bfs/face/7bce12b8b5fef2f31d215dec94fc5fc18cdd41a2.jpg" + }, + "stat": { + "aid": 514421957, + "view": 1863705, + "danmaku": 1357, + "reply": 2953, + "favorite": 3091, + "coin": 95, + "share": 25867, + "now_rank": 0, + "his_rank": 0, + "like": 16315, + "dislike": 0 + }, + "dynamic": "", + "cid": 802910768, + "dimension": { + "width": 1280, + "height": 720, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1xg411k7L1", + "up_from_v2": 8, + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220814qn1cm2zo6jetqmu2nvlcxssy1_firsti.jpg", + "pub_location": "江苏", + "bvid": "BV1xg411k7L1", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 259434557, + "videos": 1, + "tid": 218, + "tname": "喵星人", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/47d46ad72bf1898ebbfe7d82a9d972d4b53e61fc.jpg", + "title": "42度在家造溜冰场降温，猫上去直呼脚滑！", + "pubdate": 1660361400, + "ctime": 1660361407, + "desc": "刚开始真的觉得很难，不可能，学会理论知识后觉得，就这？太简单了，所以随便做做是成立的。就是学费有点贵，1w多……，我现在空调随便修！希望日后修空调能把这钱在挣回来！（溜冰场上期指路：BV1ga411f79y）\n萌宠区手工up主往期发明指路： \n猫力跑步发电机：BV1iy4y1a7Cb \n电动撸毛器：BV1H64y1v7gq\n戒烟头盔：BV1H64y1k7tz \n猫热能暖床器：BV1xF411i7tw \n全透明赏猫床：BV1Qb4y1C7sn \n写不完啦 还有很多，就要靠各位慢慢挖掘啦！", + "state": 0, + "duration": 501, + "mission_id": 859937, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 20951119, + "name": "蒂姆嘟嘟Tim", + "face": "http://i1.hdslb.com/bfs/face/9860c4c559fd2517b1fa92e592d3d71b95bb3ec2.jpg" + }, + "stat": { + "aid": 259434557, + "view": 1403315, + "danmaku": 5762, + "reply": 1295, + "favorite": 26633, + "coin": 100847, + "share": 4502, + "now_rank": 0, + "his_rank": 64, + "like": 130944, + "dislike": 0 + }, + "dynamic": "猫确实会两条腿滑冰！猫和老鼠诚不欺我", + "cid": 800970167, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 3702, + "short_link_v2": "https://b23.tv/BV1wa411Z77n", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220812a228chhkmeci9f0hizo6ivhzv_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1wa411Z77n", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 765765040, + "videos": 1, + "tid": 26, + "tname": "音MAD", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/f92297d237bc330e4c70bd7cb4b6a5988a4a35df.jpg", + "title": "向 先 辈 奔 去", + "pubdate": 1642843003, + "ctime": 1642843003, + "desc": "远野说大家听不出他的和声所以不愿意来了（迫真）\nBGM：夜に駆ける\nPV：BV1Ph411C7S5\n封面：@十人比白 \n其他作品：\n病 名 为 臭 BV1W3411Y7R3\nHomo KING BV1p3411Y7Qf\n先 辈 の 名 は BV1bF411p7W7\n野兽先辈的消失 BV1XL4y147KK", + "state": 0, + "duration": 119, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 26540403, + "name": "小王子擎天", + "face": "http://i0.hdslb.com/bfs/face/70723d05c4fcd3af47ac7e453bee06feea48b804.jpg" + }, + "stat": { + "aid": 765765040, + "view": 125123, + "danmaku": 168, + "reply": 384, + "favorite": 3518, + "coin": 878, + "share": 858, + "now_rank": 0, + "his_rank": 0, + "like": 6224, + "dislike": 0 + }, + "dynamic": "", + "cid": 490015078, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 185827, + "short_link_v2": "https://b23.tv/BV19r4y1Y7De", + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220122a26mtv7cs4x1ga3329ew4cqhb_firsti.jpg", + "bvid": "BV19r4y1Y7De", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 599348400, + "videos": 1, + "tid": 218, + "tname": "喵星人", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/6c0b56f7b2a378e32c40c2ec7cf4a34cf6e42ad2.jpg", + "title": "打开前请先降低音量哦！！", + "pubdate": 1660007700, + "ctime": 1660007701, + "desc": "日常投食小猫咪\n视频里的是两个窝次的15只崽崽\n5月30日和6月1日出生\nliliya和Tessa的宝宝", + "state": 0, + "duration": 203, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 43099315, + "name": "颖姥姥的小猪喵", + "face": "http://i1.hdslb.com/bfs/face/6261098e074624891f5f1cdf35b4df64401c4307.jpg" + }, + "stat": { + "aid": 599348400, + "view": 5611104, + "danmaku": 14300, + "reply": 8180, + "favorite": 122270, + "coin": 45195, + "share": 126333, + "now_rank": 0, + "his_rank": 5, + "like": 536114, + "dislike": 0 + }, + "dynamic": "日常投食小猫咪\n视频里的是两个窝次的15只崽崽\n5月30日和6月1日出生\nliliya和Tessa的宝宝", + "cid": 797762429, + "dimension": { + "width": 1080, + "height": 1920, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1cB4y167B8", + "up_from_v2": 9, + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220809a2ku7vu7oisum1632zs07p7dg_firsti.jpg", + "pub_location": "山东", + "bvid": "BV1cB4y167B8", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 472194944, + "videos": 1, + "tid": 162, + "tname": "绘画", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/aee4307632ecad127f60ae556cc5981f1a329c15.jpg", + "title": "有些画，不需要太清晰", + "pubdate": 1660817303, + "ctime": 1660817303, + "desc": "先画个狗头保命", + "state": 0, + "duration": 147, + "mission_id": 761022, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 28330240, + "name": "叶无趣", + "face": "http://i1.hdslb.com/bfs/face/9416d6dd723d271bdd805ccf2e44dc47436c5a07.jpg" + }, + "stat": { + "aid": 472194944, + "view": 2378719, + "danmaku": 6517, + "reply": 2815, + "favorite": 33778, + "coin": 24411, + "share": 11461, + "now_rank": 0, + "his_rank": 0, + "like": 209110, + "dislike": 0 + }, + "dynamic": "", + "cid": 807922809, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1DT411c7AD", + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220819a213lvuk7uqfgh91m9lv1esx1_firsti.jpg", + "pub_location": "湖南", + "bvid": "BV1DT411c7AD", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 599779624, + "videos": 1, + "tid": 173, + "tname": "桌游棋牌", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/70800347ccbd019b678b41318c203b8fecb9aaec.jpg", + "title": "【雀魂汪汪录】第196期 谁能给我翻译翻译 什么叫做惊喜", + "pubdate": 1661394900, + "ctime": 1661252218, + "desc": "BGM可以通过网易云搜索【雀魂汪汪录BGM】就可以找到啦！\n雀魂汪汪录 周四中午见\n微博 @雀魂麻将majsoul\n——————————————————————————\n想要投稿的玩家~务必请通过邮箱来进行投稿~【请不要在评论区或是私信投稿，谢谢】\n邮箱地址：tg@catfoodstudio.com\n投稿最少需要注明【局目、内容、牌谱链接】哦！", + "state": 0, + "duration": 575, + "mission_id": 808212, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 353240497, + "name": "雀魂麻将majsoul", + "face": "http://i1.hdslb.com/bfs/face/053f02d2a7eb96884b1020ca20d6d02241df6099.jpg" + }, + "stat": { + "aid": 599779624, + "view": 187150, + "danmaku": 1958, + "reply": 516, + "favorite": 342, + "coin": 787, + "share": 646, + "now_rank": 0, + "his_rank": 0, + "like": 7429, + "dislike": 0 + }, + "dynamic": "#雀魂# #雀魂汪汪录# #立直麻将#", + "cid": 812183140, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "season_id": 2739, + "short_link_v2": "https://b23.tv/BV1aB4y1z74J", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220823qn266np8ftodq2t2m2paam9xj_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1aB4y1z74J", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 685619632, + "videos": 1, + "tid": 17, + "tname": "单机游戏", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/750b5fabea1ff363d775ba58f95a23b5cb890be9.jpg", + "title": "多人群峦传说联机3:用木炭炉做出铜溶液，浇筑出铜镐和探矿镐！", + "pubdate": 1656756676, + "ctime": 1656756677, + "desc": "-", + "state": 0, + "duration": 268, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 1771879421, + "name": "方块局安神", + "face": "http://i2.hdslb.com/bfs/face/c3781165f41f2b4d99e7beb1356105f624cc424e.jpg" + }, + "stat": { + "aid": 685619632, + "view": 215, + "danmaku": 0, + "reply": 2, + "favorite": 1, + "coin": 0, + "share": 0, + "now_rank": 0, + "his_rank": 0, + "like": 8, + "dislike": 0 + }, + "dynamic": "", + "cid": 761921385, + "dimension": { + "width": 1920, + "height": 864, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1MU4y1D7ND", + "up_from_v2": 35, + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220702qndfrow9p4eq991lyl8em2v9w_firsti.jpg", + "pub_location": "宁夏", + "bvid": "BV1MU4y1D7ND", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 427974127, + "videos": 1, + "tid": 17, + "tname": "单机游戏", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/1f81be8fd2eec800e3134f24928b66b75c25a078.jpg", + "title": "多人群峦传说联机1:开局做出篝火和木炭窑！很快的进入陶器时代！", + "pubdate": 1656660681, + "ctime": 1656660682, + "desc": "-", + "state": 0, + "duration": 313, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 1771879421, + "name": "方块局安神", + "face": "http://i2.hdslb.com/bfs/face/c3781165f41f2b4d99e7beb1356105f624cc424e.jpg" + }, + "stat": { + "aid": 427974127, + "view": 186, + "danmaku": 0, + "reply": 7, + "favorite": 1, + "coin": 2, + "share": 0, + "now_rank": 0, + "his_rank": 0, + "like": 7, + "dislike": 0 + }, + "dynamic": "", + "cid": 760818007, + "dimension": { + "width": 1920, + "height": 864, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1MG411x7Jh", + "up_from_v2": 35, + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220701qn3ejknxipb82r1a0hut5chj5_firsti.jpg", + "pub_location": "宁夏", + "bvid": "BV1MG411x7Jh", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 602112213, + "videos": 1, + "tid": 22, + "tname": "鬼畜调教", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/5edabb39c8ac3a3202111e8e60f8e45b8b3c180d.jpg", + "title": "你被百度骗了，呵呵", + "pubdate": 1660561467, + "ctime": 1660561467, + "desc": "分区和参与活动真的合理吗（）\n很草的点子\n烂活", + "state": 0, + "duration": 62, + "mission_id": 738105, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 361685930, + "name": "啰嗦_Losso", + "face": "http://i2.hdslb.com/bfs/face/e26253ff660c19fdb953825aef990c30ad08c8dc.jpg" + }, + "stat": { + "aid": 602112213, + "view": 58957, + "danmaku": 112, + "reply": 231, + "favorite": 1401, + "coin": 514, + "share": 117, + "now_rank": 0, + "his_rank": 0, + "like": 9353, + "dislike": 0 + }, + "dynamic": "", + "cid": 804462941, + "dimension": { + "width": 828, + "height": 1792, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1yB4y1L7iG", + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220815qn31gxoi0spl1yr35uq27n3u4_firsti.jpg", + "pub_location": "美国", + "bvid": "BV1yB4y1L7iG", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 856393020, + "videos": 1, + "tid": 238, + "tname": "运动综合", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/d7edbba4eb63bb9ceed978ae46e676cb3fdbaf6a.jpg", + "title": "极限难度！不碰其他球把45颗球打入洞中！海外知名桌球博主来B站啦！", + "pubdate": 1659105213, + "ctime": 1659105213, + "desc": "", + "state": 0, + "duration": 756, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 1954176521, + "name": "桌球小哥genipool官方", + "face": "http://i2.hdslb.com/bfs/face/90ca22fa8c79d0d5042c7c24daf1ec574679a740.jpg" + }, + "stat": { + "aid": 856393020, + "view": 342876, + "danmaku": 365, + "reply": 159, + "favorite": 809, + "coin": 800, + "share": 283, + "now_rank": 0, + "his_rank": 0, + "like": 4266, + "dislike": 0 + }, + "dynamic": "", + "cid": 788065599, + "dimension": { + "width": 1280, + "height": 720, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV18V4y1E7zo", + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220729qn15m1fxzexlmvq1j541qvx6r_firsti.jpg", + "pub_location": "福建", + "bvid": "BV18V4y1E7zo", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 728238452, + "videos": 1, + "tid": 232, + "tname": "科工机械", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/6613ccabbf0828d0071efbb2351818c3cab62725.jpg", + "title": "烧脑故障，家庭漏电维修图解", + "pubdate": 1657075740, + "ctime": 1657075740, + "desc": "-", + "state": 0, + "duration": 433, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 1985127693, + "name": "城阳电工电路", + "face": "http://i0.hdslb.com/bfs/face/faae5daababbf652d97faedab1a25d78b654fc44.jpg" + }, + "stat": { + "aid": 728238452, + "view": 138664, + "danmaku": 277, + "reply": 263, + "favorite": 681, + "coin": 601, + "share": 85, + "now_rank": 0, + "his_rank": 0, + "like": 9567, + "dislike": 0 + }, + "dynamic": "", + "cid": 765013281, + "dimension": { + "width": 1080, + "height": 1920, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV12S4y1E7rt", + "up_from_v2": 8, + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220706qn257g5ymn00jrq1tbc2y0k4s_firsti.jpg", + "pub_location": "山东", + "bvid": "BV12S4y1E7rt", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 556671285, + "videos": 1, + "tid": 173, + "tname": "桌游棋牌", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/02aa212793ebfdc5bd2b243109961d01ef74015f.jpg", + "title": "【整活向】麻将新手不常见错误示范——偷换牌山", + "pubdate": 1659761706, + "ctime": 1659761706, + "desc": "大家千万不要学习@肉目 的反面教材噢\n不然胡萝卜很快就被切光了", + "state": 0, + "duration": 61, + "mission_id": 808212, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 1, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 5256791, + "name": "凤鸣麻雀社", + "face": "http://i2.hdslb.com/bfs/face/79c578d5a00dc25498913187f1e2e7b63463b027.jpg" + }, + "stat": { + "aid": 556671285, + "view": 28016, + "danmaku": 17, + "reply": 62, + "favorite": 25, + "coin": 34, + "share": 22, + "now_rank": 0, + "his_rank": 0, + "like": 845, + "dislike": 0 + }, + "dynamic": "健康麻将 保护胡萝卜 从@肉目 做起\n玩儿花的手法是越来越熟练了 危险危险", + "cid": 795200966, + "dimension": { + "width": 1080, + "height": 1440, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV12e4y1D7mp", + "up_from_v2": 8, + "first_frame": "http://i0.hdslb.com/bfs/storyff/n220806a21h7h5icb0b5fv1v71d6cwu7_firsti.jpg", + "pub_location": "广东", + "bvid": "BV12e4y1D7mp", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 471592118, + "videos": 1, + "tid": 59, + "tname": "演奏", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/3f1fcd0461235f8881a86faaa1321744b251b26f.jpg", + "title": "有仪式感的植物大战僵尸", + "pubdate": 1659409876, + "ctime": 1659409876, + "desc": "-", + "state": 0, + "duration": 150, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 523219895, + "name": "上官画画", + "face": "http://i2.hdslb.com/bfs/face/a69355ca44c5343e202e1e1294245ba588e92e96.jpg" + }, + "stat": { + "aid": 471592118, + "view": 314596, + "danmaku": 302, + "reply": 630, + "favorite": 2532, + "coin": 2648, + "share": 1294, + "now_rank": 0, + "his_rank": 0, + "like": 20552, + "dislike": 0 + }, + "dynamic": "", + "cid": 791291889, + "dimension": { + "width": 960, + "height": 540, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1WT41177PD", + "up_from_v2": 36, + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220802qn3bbryqe32dploiilb7xtqft_firsti.jpg", + "pub_location": "浙江", + "bvid": "BV1WT41177PD", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 599162361, + "videos": 1, + "tid": 238, + "tname": "运动综合", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/bc086df16873a9bc619d625bc176359220062d79.jpg", + "title": "张镇辉台球正经教学【6个不太建议使用的技巧】15.0版本", + "pubdate": 1659690000, + "ctime": 1659690022, + "desc": "靓仔，用一句话证明你是老粉！！\n \n \n \n长按点赞，有彩蛋哟～", + "state": 0, + "duration": 119, + "mission_id": 846900, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 88895225, + "name": "张镇辉台球教学", + "face": "http://i2.hdslb.com/bfs/face/2af69641c86d3915440b28ef64214e112390c15c.jpg" + }, + "stat": { + "aid": 599162361, + "view": 2275313, + "danmaku": 23143, + "reply": 2608, + "favorite": 22825, + "coin": 15344, + "share": 3584, + "now_rank": 0, + "his_rank": 73, + "like": 243787, + "dislike": 0 + }, + "dynamic": "", + "cid": 794017093, + "dimension": { + "width": 2160, + "height": 3840, + "rotate": 0 + }, + "season_id": 39377, + "short_link_v2": "https://b23.tv/BV1CB4y1r7d5", + "first_frame": "http://i2.hdslb.com/bfs/storyff/n220805qn1xjr322hy7j1tc0t7ntj0r3_firsti.jpg", + "pub_location": "广东", + "bvid": "BV1CB4y1r7d5", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + }, + { + "aid": 729057411, + "videos": 1, + "tid": 59, + "tname": "演奏", + "copyright": 1, + "pic": "http://i1.hdslb.com/bfs/archive/365e41383e10a774d54b908c018e66a0f90bcc65.jpg", + "title": "今天练练脚下钢琴", + "pubdate": 1659322244, + "ctime": 1659322244, + "desc": "-", + "state": 0, + "duration": 16, + "mission_id": 741439, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0, + "arc_pay": 0, + "pay_free_watch": 0 + }, + "owner": { + "mid": 397865300, + "name": "Rhythm梦龙", + "face": "http://i2.hdslb.com/bfs/face/297f26c89a43d60619e552d5606e575d2a8406aa.jpg" + }, + "stat": { + "aid": 729057411, + "view": 17740, + "danmaku": 8, + "reply": 27, + "favorite": 74, + "coin": 37, + "share": 20, + "now_rank": 0, + "his_rank": 0, + "like": 1878, + "dislike": 0 + }, + "dynamic": "", + "cid": 790320365, + "dimension": { + "width": 1080, + "height": 1920, + "rotate": 0 + }, + "short_link_v2": "https://b23.tv/BV1zS4y1x7ZM", + "up_from_v2": 9, + "first_frame": "http://i1.hdslb.com/bfs/storyff/n220801qn337b2rig3v6l23kyehiinaa_firsti.jpg", + "pub_location": "上海", + "bvid": "BV1zS4y1x7ZM", + "inter_video": false, + "resource_type": "ugc", + "subtitle": "" + } + ] + } +} +``` + +
+
+### 查询用户投稿视频明细
+
+> https://api.bilibili.com/x/space/wbi/arc/search
+
+> https://api.bilibili.com/x/space/arc/search （旧）
+
+PS：旧 api 存在一些不同，比如某些情况下，例如 mid=2 时如果没有设置 Cookie 则出现非法访问（-401），但新 api 不会。
+
+
+*请求方式：GET*
+
+**header字段：**
+
+必须要有 `user-agent`，且不能为 `空字符串`，以及含有 `python`、`node`、`curl` 等的字符串。
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|---------|-----|---------|-----|-------------------------------------------------------------|
+| mid | num | 目标用户mid | 必要 | |
+| order | str | 排序方式 | 非必要 | 默认为pubdate最新发布：pubdate
最多播放：click
最多收藏：stow | +| tid | num | 筛选目标分区 | 非必要 | 默认为0
0：不进行分区筛选
分区tid为所筛选的分区 | +| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 | +| pn | num | 页码 | 非必要 | | +| ps | num | 每页项数 | 非必要 | 最小1，最大50，默认30 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|----------------------------------------------------------------------| +| code | num | 返回值 | 0：成功
-400：请求错误
-412：请求被拦截
-1200：被降级过滤的请求(一种意义不明的偶发状况) | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-----------------|------|----------|-----| +| list | obj | 列表信息 | | +| page | obj | 页面信息 | | +| episodic_button | obj | “播放全部“按钮 | | +| is_risk | bool | | | +| gaia_res_type | num | | | +| gaia_data | | | | + +`data`中的`list`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-------|----------|-----| +| tlist | obj | 投稿视频分区索引 | | +| vlist | array | 投稿视频列表 | | + +`list`中的`tlist`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-----|--------|--------------| +| {tid} | obj | 该分区的详情 | 字段名为存在的分区tid | +| …… | obj | …… | 向下扩展 | + +`tlist`中的`{tid}`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-----|------------|-----| +| count | num | 投稿至该分区的视频数 | | +| name | str | 该分区名称 | | +| tid | num | 该分区tid | | + +`list`中的`vlist`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|-----------|-----| +| 0 | obj | 投稿视频1 | | +| n | obj | 投稿视频（n+1） | | +| …… | obj | …… | …… | + +`list`中的`vlist`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|------------------|------|----------|--------------------------------------------------------------------------------| +| aid | num | 稿件avid | | +| author | str | 视频UP主 | 不一定为目标用户（合作视频） | +| bvid | str | 稿件bvid | | +| comment | num | 视频评论数 | | +| copyright | str | 空 | 作用尚不明确 | +| created | num | 投稿时间 | 时间戳 | +| description | str | 视频简介 | | +| hide_click | bool | false | 作用尚不明确 | +| is_pay | num | 0 | 作用尚不明确 | +| is_union_video | num | 是否为合作视频 | 0：否
1：是 | +| length | str | 视频长度 | MM:SS | +| mid | num | 视频UP主mid | 不一定为目标用户（合作视频） | +| pic | str | 视频封面 | | +| play | num | 视频播放次数 | 如果视频基本信息API对应的状态为-403视频访问权限不足，数据类型将变为str，如（"play": "--",），于mid79发表的av5132474可见 | +| review | num | 0 | 作用尚不明确 | +| subtitle | str | 空 | 作用尚不明确 | +| title | str | 视频标题 | | +| typeid | num | 视频分区tid | | +| video_review | num | 视频弹幕数 | | +| is_steins_gate | num | 0 | | +| is_live_playback | num | 0 | | +| meta | | | | +| is_avoided | num | 0 | | +| attribute | num | 0 | | + +`data`中的`page`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-----|-------|-----| +| count | num | 总计稿件数 | | +| pn | num | 当前页码 | | +| ps | num | 每页项数 | | + +`data`中的`episodic_button`对象： + +| 字段 | 类型 | 内容 | 备注 | +|------|-----|----------|-----| +| text | str | 按钮文字 | | +| uri | str | 全部播放页url | | + +**示例：** + +`pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容 + +以每页2项查询用户`mid=53456`的第1页投稿视频明细 + +```shell +curl -G 'https://api.bilibili.com/x/space/wbi/arc/search' \ +--data-urlencode 'mid=53456' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +--user-agent 'go' +``` + +
+
+
+### 查询用户投稿相簿预览
+
+> https://api.bilibili.com/x/space/album/index
+
+*请求方式：GET*
+
+所有类型的相簿
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|---------|-----|----------------------------|
+| mid | num | 目标用户mid | 必要 | |
+| ps | num | 获取的相簿量 | 非必要 | 默认为8 定义域 1-大于1700 (注意滥用风险) |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-------|------|---------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": { + "tlist": { + "1": { + "tid": 1, + "count": 41, + "name": "动画" + }, + "3": { + "tid": 3, + "count": 36, + "name": "音乐" + }, + "4": { + "tid": 4, + "count": 82, + "name": "游戏" + }, + "36": { + "tid": 36, + "count": 1, + "name": "知识" + }, + "160": { + "tid": 160, + "count": 49, + "name": "生活" + }, + "211": { + "tid": 211, + "count": 3, + "name": "美食" + }, + "217": { + "tid": 217, + "count": 2, + "name": "动物圈" + } + }, + "vlist": [ + { + "comment": 6729, + "typeid": 172, + "play": 2171260, + "pic": "http://i2.hdslb.com/bfs/archive/9fe04c2acb6678c9a8d1547db211e458ea70982c.jpg", + "subtitle": "", + "description": "好开心能和几千人一起看音乐会！真的震撼到我了，它给我带来的冲击感远超出了我的想象……光遇这场音乐会会一直持续到元旦哦，大家感兴趣的话也可以来试试吧~\n祝看得开心啦！", + "copyright": "1", + "title": "【warma】我尝试学习交朋友", + "review": 0, + "author": "Warma", + "mid": 53456, + "created": 1671163200, + "length": "23:58", + "video_review": 7931, + "aid": 433873134, + "bvid": "BV1nG411P7hf", + "hide_click": false, + "is_pay": 0, + "is_union_video": 0, + "is_steins_gate": 0, + "is_live_playback": 0, + "meta": null, + "is_avoided": 0, + "attribute": 0 + }, + { + "comment": 3380, + "typeid": 31, + "play": 811600, + "pic": "http://i2.hdslb.com/bfs/archive/7e6c6ec32a0db8684abd660d599644e9d1c43ee4.jpg", + "subtitle": "", + "description": "原曲：BV1iR4y1X7V9\n这首歌是今年生日的时候收到的礼物，真的太好听了！我也想翻唱试试~\n在翻唱中录了一些不一样的小音效，比如卡祖笛和竖笛，还录了些小配音……大家来听听看！\n谢谢原曲staff老师们做出这么有趣的作品，谢谢在这次翻唱中staff老师们的帮助（PV老师甚至根据翻唱版本把曲子的PV做了些修改，加了好多小细节，真的超用心！）\n祝听得开心啦~\n \n【staff表】\n原曲staff：详见BV1iR4y1X7V9\n翻唱：warma\n混音：白萝卜音乐工作室\nPV修改：@颜一bot \n封面：是根", + "copyright": "1", + "title": "【warma】来唱大家送我的歌！《夏天幻游日记》", + "review": 0, + "author": "Warma", + "mid": 53456, + "created": 1670558400, + "length": "02:59", + "video_review": 2343, + "aid": 733323002, + "bvid": "BV18D4y1Y7o6", + "hide_click": false, + "is_pay": 0, + "is_union_video": 0, + "is_steins_gate": 0, + "is_live_playback": 0, + "meta": null, + "is_avoided": 0, + "attribute": 0 + } + ] + }, + "page": { + "pn": 1, + "ps": 2, + "count": 214 + }, + "episodic_button": { + "text": "播放全部", + "uri": "//www.bilibili.com/medialist/play/53456?from=space" + }, + "is_risk": false, + "gaia_res_type": 0, + "gaia_data": null + } +} +``` + +-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 相簿列表 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|-----------|-----| +| 0 | obj | 相簿内容1 | | +| n | obj | 相簿内容（n+1） | | +| …… | obj | …… | …… | + +`data`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------------|-------|---------|--------| +| count | num | 总计图片数 | | +| ctime | num | 发布时间 | 时间戳 | +| description | str | 简介 | | +| doc_id | num | 相簿id | 非动态！！！ | +| like | num | 点赞数 | | +| pictures | array | 图片内容 | | +| poster_uid | num | 上传用户mid | | +| title | str | 标题 | 动态内容无 | +| view | num | 浏览数 | | + +`data`数组中的对象中的`pictures`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|-----------|----------------| +| 0 | obj | 内容图片1 | | +| n | obj | 内容图片（n+1） | 项数取决于`count`的值 | +| …… | obj | …… | …… | + +`pictures`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|------------|-----|-------|----------| +| img_height | num | 图片高度 | | +| img_size | num | 图片大小 | 单位为KByte | +| img_src | str | 图片url | | +| img_width | num | 图片宽度 | | + +**示例：** + +查询用户`mid=53456`的投稿相簿预览 + +```shell +curl -G 'https://api.bilibili.com/x/space/album/index' \ +--data-urlencode 'mid=53456' \ +--data-urlencode 'ps=2' +``` + +
+
+
+### 查询用户投稿相簿明细
+
+> https://api.vc.bilibili.com/link_draw/v1/doc/doc_list
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----------|-----|---------|-----|-------------------------------------------------------------|
+| uid | num | 目标用户mid | 必要 | |
+| page_num | num | 页码 | 非必要 | 默认为0 |
+| page_size | num | 每页项数 | 必要 | 默认为30 |
+| biz | str | 查询类型 | 非必要 | 全部：all查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [{ + "doc_id": 60470424, + "poster_uid": 53456, + "title": "", + "description": "你醒啦！[tv_大佬]\n之前说到过的百万粉纪念的视频已经定时在了今天下午七点，欢迎来看呀！", + "pictures": [{ + "img_src": "https://i0.hdslb.com/bfs/album/2840366e30bf7c0aba9da5adde1a771255a57bc7.jpg", + "img_width": 625, + "img_height": 134, + "img_size": 14 + }], + "count": 1, + "ctime": 1583444859, + "view": 1677521, + "like": 29974 + }, { + "doc_id": 58962388, + "poster_uid": 53456, + "title": "", + "description": "上次的那些写实儿童画发出来啦！可以打印下来辟邪[tv_大佬]", + "pictures": [{ + "img_src": "https://i0.hdslb.com/bfs/album/8acaf7c7897cb858cccab36c33a5e875adfef177.jpg", + "img_width": 2172, + "img_height": 3258, + "img_size": 2831 + }, { + "img_src": "https://i0.hdslb.com/bfs/album/1611b6b56d3d4328889a62b9f9bdc92e9d065532.jpg", + "img_width": 3456, + "img_height": 5184, + "img_size": 3024 + }, { + "img_src": "https://i0.hdslb.com/bfs/album/f3a30a2ef5b39711af8b945d54d85ffd1e932b8a.jpg", + "img_width": 1200, + "img_height": 757, + "img_size": 313 + }], + "count": 3, + "ctime": 1582881332, + "view": 1176646, + "like": 25734 + }] +} +``` + +绘画：draw
摄影：photo
日常：daily
默认为all | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|------------| +| code | num | 返回值 | 0：成功 | +| msg | str | 错误信息 | 默认为success | +| message | str | 错误信息 | 默认为success | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-------|------|-----| +| items | array | 相簿列表 | | + +`items`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|-----------|-----| +| 0 | obj | 相簿内容1 | | +| n | obj | 相簿内容（n+1） | | +| …… | obj | …… | …… | + +`items`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------------|-------|---------|--------| +| count | num | 总计图片数 | | +| ctime | num | 发布时间 | 时间戳 | +| description | str | 简介 | | +| doc_id | num | 相簿id | 非动态！！！ | +| like | num | 点赞数 | | +| pictures | array | 图片内容 | | +| poster_uid | num | 上传用户mid | | +| title | str | 标题 | 动态内容无 | +| view | num | 浏览数 | | + +`items`数组中的对象中的`pictures`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|-----------|----------------| +| 0 | obj | 内容图片1 | | +| n | obj | 内容图片（n+1） | 项数取决于`count`的值 | +| …… | obj | …… | …… | + +`pictures`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|------------|-----|-------|----------| +| img_height | num | 图片高度 | | +| img_size | num | 图片大小 | 单位为KByte | +| img_src | str | 图片url | | +| img_width | num | 图片宽度 | | + +**示例：** + +查询用户`mid=53456`的投稿明细中的全部类型 + +```shell +curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \ +--data-urlencode 'uid=2' \ +--data-urlencode 'page_num=1' \ +--data-urlencode 'page_size=2' \ +--data-urlencode 'biz=all' +``` + +
+
+
+## 频道
+
+查看响应示例：
+ +```json +{ + "code": 0, + "msg": "success", + "message": "success", + "data": { + "items": [{ + "doc_id": 59015720, + "poster_uid": 2, + "title": "", + "description": "6影是真的无脑，2个宝石都护不住（设计师：这真是太酷了）", + "pictures": [{ + "img_src": "http://i0.hdslb.com/bfs/album/8456f050ec8639c6e0cef36aba27bfdedc550590.jpg", + "img_width": 1824, + "img_height": 840, + "img_size": 1024 + }], + "count": 1, + "ctime": 1582894607, + "view": 707073, + "like": 7055 + }, { + "doc_id": 46853140, + "poster_uid": 2, + "title": "", + "description": "#年度报告# #新年Flag# https://www.bilibili.com/blackboard/timemachine2019.html\n决定了，这就是我的新年Flag！今年我一定要…", + "pictures": [{ + "img_src": "http://i0.hdslb.com/bfs/album/5b3ae76f79d7cf2501afc3ca7c7da509dcf0e38a.jpg", + "img_width": 1125, + "img_height": 2184, + "img_size": 465 + }, { + "img_src": "http://i0.hdslb.com/bfs/album/87789fe9644337a1f7e6a0655a32584705af8bda.jpg", + "img_width": 1125, + "img_height": 2184, + "img_size": 421 + }, { + "img_src": "http://i0.hdslb.com/bfs/album/f752d7f3bb7952f6c0013b3f48ddcb07060b4721.jpg", + "img_width": 1125, + "img_height": 2184, + "img_size": 524 + }, { + "img_src": "http://i0.hdslb.com/bfs/active/7a52a411bccb716c8e67fe70e6c330d5209346de.jpg", + "img_width": 1125, + "img_height": 2184, + "img_size": 534 + }], + "count": 4, + "ctime": 1577966163, + "view": 833193, + "like": 5667 + }] + } +} +``` + +
+
+### 查询用户频道列表
+
+> https://api.bilibili.com/x/space/channel/list
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|---------|-----|-----|
+| mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|----------------------------|
+| code | num | 返回值 | 0：成功 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | 无则为空 所有频道内均无视频则为空，此时code为0 |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|-------|-------|-------|-----|
+| count | num | 总计频道数 | |
+| list | array | 频道列表 | |
+
+`data`中的`list`数组：
+
+| 项 | 类型 | 内容 | 备注 |
+|-----|-----|---------|----------------|
+| 0 | obj | 频道1 | |
+| n | obj | 频道（n+1） | 项数取决于`count`的值 |
+| …… | obj | …… | …… |
+
+`data`中的`list`数组中的对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|-------|-----|---------|------|
+| cid | num | 频道id | |
+| count | num | 频道内含视频数 | |
+| cover | str | 封面图片url | |
+| intro | str | 简介 | 无则为空 |
+| mid | num | 创建用户mid | |
+| mtime | num | 创建时间 | 时间戳 |
+| name | str | 标题 | |
+
+**示例：**
+
+查询用户`mid=53456`的频道列表
+
+```shell
+curl -G 'https://api.bilibili.com/x/space/channel/list' \
+--data-urlencode 'mid=53456'
+```
+
+
+
+
+
+
+### 查询用户频道中的视频
+
+> https://api.bilibili.com/x/space/channel/video
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|---------|-----|--------|
+| mid | num | 目标用户mid | 必要 | |
+| cid | num | 目标频道id | 必要 | |
+| pn | num | 页码 | 非必要 | 默认为1 |
+| ps | num | 每页项数 | 非必要 | 默认为100 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|----------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "count": 6, + "list": [{ + "cid": 100249, + "mid": 53456, + "name": "【实况】动物之森", + "intro": "", + "mtime": 1579898830, + "count": 2, + "cover": "http://i1.hdslb.com/bfs/archive/6a7ed9483c34e839dfca981b9e2b94cd4c4efa0a.jpg" + }, { + "cid": 79323, + "mid": 53456, + "name": "忆雨", + "intro": "忆雨出现过的视频", + "mtime": 1562535222, + "count": 7, + "cover": "http://i2.hdslb.com/bfs/archive/1783e4f03042b282495799adda1cb56270cea647.jpg" + }, { + "cid": 79322, + "mid": 53456, + "name": "大画家", + "intro": "", + "mtime": 1562535122, + "count": 6, + "cover": "http://i0.hdslb.com/bfs/archive/9c85a14e805c6c23cb7a42e1dbef97821bb68960.jpg" + }, { + "cid": 77758, + "mid": 53456, + "name": "灭火器", + "intro": "", + "mtime": 1561270856, + "count": 4, + "cover": "http://i2.hdslb.com/bfs/archive/0073208d086b4ebe9cdc540e7664aa74b483aeb6.jpg" + }, { + "cid": 75696, + "mid": 53456, + "name": "沃玛小剧场", + "intro": "", + "mtime": 1559129460, + "count": 5, + "cover": "http://i2.hdslb.com/bfs/archive/db2b20ecdb6ed013fc3780b0e741ea88d46b5b40.jpg" + }, { + "cid": 170, + "mid": 53456, + "name": "爆炸电台", + "intro": "闲聊的电台", + "mtime": 1503298893, + "count": 7, + "cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg" + }] + } +} +``` + +-400：请求错误
-404：无用户对应的频道 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|------|-----|------|-----| +| list | obj | 频道信息 | | +| page | obj | 页面信息 | | + +`data`中的`list`对象： + +| 字段 | 类型 | 内容 | 备注 | +|----------|-------|---------|------| +| archives | array | 包含的视频列表 | | +| cid | num | 频道id | | +| count | num | 频道内含视频数 | | +| cover | str | 封面图片url | | +| intro | str | 简介 | 无则为空 | +| mid | num | 创建用户mid | | +| mtime | num | 创建时间 | 时间戳 | +| name | str | 标题 | | + +`list`中的`archives`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|---------|----------------| +| 0 | obj | 视频1 | | +| n | obj | 视频（n+1） | 项数取决于`count`的值 | +| …… | obj | …… | …… | + +`list`中的`archives`数组中的对象： + +基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avid/bvid互转）)」中的data对象 + +`data`中的`page`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ---------- | ---- | +| count | num | 总计视频数 | | +| num | num | 当前页码 | | +| size | num | 每页项数 | | + +**示例：** + +查询用户`mid=53456`的频道`170`中的视频 + +```shell +curl -G 'https://api.bilibili.com/x/space/channel/video' \ +--data-urlencode 'mid=53456' \ +--data-urlencode 'cid=170' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' +``` + +
+
+
+### 创建频道
+
+> https://api.bilibili.com/x/space/channel/add
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+创建成功后会返回新建频道的id
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-------|-----|----------------------|-----|-----|
+| name | str | 频道名 | 必要 | |
+| intro | str | 频道简介 | 非必要 | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": { + "cid": 170, + "mid": 53456, + "name": "爆炸电台", + "intro": "闲聊的电台", + "mtime": 1503298893, + "count": 7, + "cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg", + "archives": [{ + "aid": 87673204, + "videos": 1, + "tid": 21, + "tname": "日常", + "copyright": 1, + "pic": "http://i0.hdslb.com/bfs/archive/5387bdcbbe4d5551adbf0ee2e607e4b7d3d8f2f0.jpg", + "title": "【warma爆炸电台】迟来的自我介绍【第八期】", + "pubdate": 1581244539, + "ctime": 1581244540, + "desc": "时隔半年的新的一期爆炸电台来啦，这是我的一系列杂谈聊天电台，这次因为多了很多新关注的朋友们，所以来做个自我介绍吧！\n画师：Dr-H_喵_ 动画：K_Lacid\n结尾提到的壁纸稍后在动态发原图，动态壁纸在steam那个壁纸软件的创意工坊里搜warma能找到\n\n往期的电台：\n第一期：av6786024 \n第三期：av13619263\n第四期：av18862091\n第五期：av25092410\n第六期：av42492515\n第七期：av62910468", + "state": 0, + "attribute": 16512, + "duration": 2388, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0 + }, + "owner": { + "mid": 53456, + "name": "Warma", + "face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg" + }, + "stat": { + "aid": 87673204, + "view": 1383542, + "danmaku": 88908, + "reply": 9237, + "favorite": 32929, + "coin": 68849, + "share": 5140, + "now_rank": 0, + "his_rank": 52, + "like": 116164, + "dislike": 0 + }, + "dynamic": "来做个自我介绍吧！ #warma##沃玛##爆炸电台#", + "cid": 149793525, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "bvid": "BV1D7411t7Be", + "inter_video": false + }, { + "aid": 62910468, + "videos": 1, + "tid": 21, + "tname": "日常", + "copyright": 1, + "pic": "http://i2.hdslb.com/bfs/archive/4bd598f71a144d4505e259b143c0de0bf27968b2.jpg", + "title": "【warma爆炸电台】居然收到了几千条问题！【第七期】", + "pubdate": 1565345410, + "ctime": 1565338559, + "desc": "时隔半年的爆炸电台第七期终于来啦！在这一期里回答了很多问题，祝看得开心！此外，就在昨天，50万订阅了…真的谢谢大家！\n也欢迎来看往期的电台：\n第一期：av6786024 （2016年10月）\n第二期：av10373352（2017年5月）\n第三期：av13619263（2017年8月）\n第四期：av18862091（2018年1月）\n第五期：av25092410（2018年6月）\n第六期：av42492515（2019年2月）", + "state": 0, + "attribute": 16512, + "duration": 1987, + "mission_id": 11740, + "rights": { + "bp": 0, + "elec": 0, + "download": 0, + "movie": 0, + "pay": 0, + "hd5": 0, + "no_reprint": 1, + "autoplay": 1, + "ugc_pay": 0, + "is_cooperation": 0, + "ugc_pay_preview": 0, + "no_background": 0 + }, + "owner": { + "mid": 53456, + "name": "Warma", + "face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg" + }, + "stat": { + "aid": 62910468, + "view": 455277, + "danmaku": 19383, + "reply": 2108, + "favorite": 10507, + "coin": 19422, + "share": 1208, + "now_rank": 0, + "his_rank": 0, + "like": 31515, + "dislike": 0 + }, + "dynamic": "爆炸电台 第七期 来啦！", + "cid": 109284065, + "dimension": { + "width": 1920, + "height": 1080, + "rotate": 0 + }, + "bvid": "BV1gt411K7Ga", + "inter_video": false + }] + }, + "page": { + "count": 7, + "num": 1, + "size": 2 + } + } +} +``` + +-101：账号未登录
-111：csrf校验失败
-400：请求错误
53001：频道名字数超过限制
53002：频道简介字数超过限制
53004：创建的频道已经满额
53007：频道名称已经存在
53024：编辑内容命中敏感信息 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 数据本体 | 成功有此项 | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-----|-----|------|-----| +| cid | num | 频道id | | + +**示例：** + +创建名为`test1`的频道，简介为空 + +```shell +curl 'https://api.bilibili.com/x/space/channel/add' \ +--data-urlencode 'name=test1' \ +--data-urlencode 'intro=' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 修改频道
+
+> https://api.bilibili.com/x/space/channel/edit
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-------|-----|----------------------|-----|-----|
+| cid | num | 频道id | 必要 | |
+| name | str | 频道名 | 必要 | |
+| intro | str | 频道简介 | 非必要 | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|---------------------------------------------------------------------------------------------------------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "cid": 138996 + } +} +``` + +-101：账号未登录
-111：csrf校验失败
-400：请求错误
53001：频道名字数超过限制
53002：频道简介字数超过限制
53007：频道名称已经存在
53024：编辑内容命中敏感信息 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +修改频道`138996`名称为`测试`，简介为`123456` + +```shell +curl 'https://api.bilibili.com/x/space/channel/edit' \ +--data-urlencode 'cid=138996' \ +--data-urlencode 'name=测试' \ +--data-urlencode 'intro=123456' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 删除频道
+
+> https://api.bilibili.com/x/space/channel/del
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------ | ---- |
+| cid | num | 需要删除的频道id | 必要 | |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-101：账号未登录
-111：csrf校验失败
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +删除频道`138996` + +```shell +curl 'https://api.bilibili.com/x/space/channel/del' \ +--data-urlencode 'cid=138996' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 频道添加视频
+
+> https://api.bilibili.com/x/space/channel/video/add
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+仅能添加自己是UP主的视频
+
+如添加多个视频，仅会添加正确的
+
+**注：完成后需要使用接口「查询用户频道中的视频」刷新**
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------|------|----------------------|-----|----------------|
+| cid | num | 频道id | 必要 | |
+| aids | nums | 要添加的目标稿件avid | 必要 | 多个使用","（%2C）分隔 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-------|------------|----------------------------------------------------------------------------------------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-101：账号未登录
-111：csrf校验失败
-400：请求错误
-404：无此项
53003：本频道里的视频已满
53006：提交视频已失效或频道里有（非该视频UP主） | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | array | 出错稿件avid列表 | | + +`data`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|---------------|-----| +| 0 | num | 出错稿件avid1 | | +| n | num | 出错稿件avid（n+1） | | +| …… | num | …… | …… | + +**示例：** + +向频道`138995`中添加视频`av583785685`和`av243322853` + +```shell +curl 'https://api.bilibili.com/x/space/channel/video/add' \ +--data-urlencode 'cid=138995' \ +--data-urlencode 'aids=583785685,243322853' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 频道删除视频
+
+> https://api.bilibili.com/x/space/channel/video/del
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**注：完成后需要使用接口「查询用户频道中的视频」刷新**
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|--------------|-----|-----|
+| cid | num | 频道id | 必要 | |
+| aid | num | 要删除的目标稿件avid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|-------------------------------------------------------------------------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": [] +} +``` + +-101：账号未登录
-111：csrf校验失败
-400：请求错误
-404：无此项
53008：频道内没有视频
53009：频道内没有该视频 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +删除频道`138995`中的视频`av583785685` + +```shell +curl 'https://api.bilibili.com/x/space/channel/video/del' \ +--data-urlencode 'cid=138995' \ +--data-urlencode 'aid=583785685' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 调整频道视频排序
+
+> https://api.bilibili.com/x/space/channel/video/sort
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------|-----|----------------------|-----|-----------------------------------------|
+| cid | num | 频道id | 必要 | |
+| aid | num | 要移动的目标稿件avid | 必要 | |
+| to | num | 视频排序倒数位置 | 非必要 | 默认为1查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +1为列表底部，视频总数为首端
与显示顺序恰好相反 | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|--------------------------------------------------------| +| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +调整`138995`中的视频`av583785685`位置为倒数第2 + +```shell +curl 'https://api.bilibili.com/x/space/channel/video/sort' \ +--data-urlencode 'cid=138995' \ +--data-urlencode 'aid=583785685' \ +--data-urlencode 'to=2' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 检查频道中有无失效视频
+
+> https://api.bilibili.com/x/space/channel/video/check
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|--------|-----|-----|
+| cid | num | 目标频道id | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|-----------------------------------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +-101：账号未登录
-400：请求错误
-404：无此项
53005：频道内有失效视频 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +检查频道`138995` + +```shell +curl -G 'https://api.bilibili.com/x/space/channel/video/check +--data-urlencode 'cid=138995' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 收藏
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +
+
+### 查询用户创建的视频收藏夹
+
+> https://api.bilibili.com/x/v3/fav/folder/created/list-all
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+查看私有收藏夹时需要认证
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|--------|-----|---------|-----|-----|
+| up_mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----------------------|------|---------------------|
+| code | num | 返回值 | 0：成功-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | 隐藏时：null
公开时：obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-----------------------------|---------|-----| +| count | num | 创建的收藏夹数 | | +| list | 无收藏夹时：null
有收藏夹时：array | 收藏夹列表 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|----------|----------------| +| 0 | obj | 收藏夹1 | | +| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 | +| …… | obj | …… | | + +`data`中的`list`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------------|-----|-----------|-----------| +| id | num | 收藏夹mlid | | +| fid | num | 原始收藏夹mlid | 去除两位mid尾号 | +| mid | num | 创建用户mid | | +| attr | num | 收藏夹属性位配置 | | +| title | str | 收藏夹标题 | | +| fav_state | num | 0 | 作用尚不明确 | +| media_count | num | 收藏夹总计视频数 | | + +`attr`属性位二进制值表： + +| 位 | 内容 | 备注 | +|-----------|----------|----------------------| +| 0 | 是否为默认收藏夹 | 0：默认收藏夹
1：其他收藏夹 | +| 1 | 私有收藏夹 | 0：公开
1：私有 | +| 其他有待补充... | | | + +**示例：** + +查询用户`mid=7792521`的收藏夹列表 + +```shell +curl -G 'https://api.bilibili.com/x/v3/fav/folder/created/list-all' \ +--data-urlencode 'up_mid=7792521' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 查询用户收藏的视频收藏夹
+
+> https://api.bilibili.com/x/v3/fav/folder/collected/list
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|--------|-----|---------|-----|--------------|
+| ps | num | 每页项数 | 必要 | 定义域 1 - 大于70 |
+| pn | num | 页码 | 必要 | |
+| up_mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----------------------|------|---------------------------------------------------------|
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "count": 5, + "list": [{ + "id": 44233921, + "fid": 442339, + "mid": 7792521, + "attr": 0, + "title": "默认收藏夹", + "fav_state": 0, + "media_count": 85 + }, { + "id": 936347621, + "fid": 9363476, + "mid": 7792521, + "attr": 22, + "title": "放假君的鬼畜私房歌", + "fav_state": 0, + "media_count": 2 + }, { + "id": 845218621, + "fid": 8452186, + "mid": 7792521, + "attr": 22, + "title": "♪一言不合就开唱♪", + "fav_state": 0, + "media_count": 4 + }, { + "id": 844998121, + "fid": 8449981, + "mid": 7792521, + "attr": 22, + "title": "个人作品精选", + "fav_state": 0, + "media_count": 25 + }, { + "id": 381779121, + "fid": 3817791, + "mid": 7792521, + "attr": 22, + "title": "鬼畜小课堂", + "fav_state": 0, + "media_count": 25 + }] + } +} +``` + +-101：账号未登录
-111：csrf校验失败
40022：签名过长 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | 隐藏时：null
公开时：obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-----------------------------|---------|-----| +| count | num | 创建的收藏夹数 | | +| list | 无收藏夹时：null
有收藏夹时：array | 收藏夹列表 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|----------|----------------| +| 0 | obj | 收藏夹1 | | +| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 | +| …… | obj | …… | | + +`data`中的`list`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------------|-----|------------|----------------------------| +| id | num | 收藏夹ml | | +| fid | num | 原始收藏夹mlid | 去除两位mid尾号 | +| mid | num | 创建用户mid | | +| attr | num | 收藏夹属性 | 转换成8-bit二进制处理
详细说明见下表 | +| title | str | 收藏夹标题 | | +| cover | str | 收藏夹封面图片url | | +| upper | obj | 收藏夹创建用户信息 | | +| cover_type | num | 2 | 作用尚不明确 | +| intro | str | 空 | 作用尚不明确 | +| ctime | num | 创建时间 | 时间戳 | +| mtime | num | 审核时间 | 时间戳 | +| state | num | 0 | 作用尚不明确 | +| fav_state | num | 0 | 作用尚不明确 | +| media_count | num | 收藏夹总计视频数 | | + +`attr`属性二进制值表： + +| 其他有待补充... | 1：默认收藏夹 | 0：公开性 | +|-----------|----------------------|----------------| +| | 0：默认收藏夹
1：其他收藏夹 | 0：公开
1：私有 | + +`data`中的`list`数组中的对象中的`upper`对象： + +| 字段 | 类型 | 内容 | 备注 | +|------|-----|--------|--------| +| mid | num | 创建人mid | | +| name | str | 创建人昵称 | | +| face | str | 空 | 作用尚不明确 | + +**示例：** + +查询用户`mid=293793435`的收藏夹收藏列表 + +```shell +curl -G 'https://api.bilibili.com/x/v3/fav/folder/collected/list' \ +--data-urlencode 'up_mid=293793435' \ +--data-urlencode 'ps=20' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 课程
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "count": 2, + "list": [{ + "id": 496307088, + "fid": 4963070, + "mid": 412466388, + "attr": 22, + "title": "入站必刷", + "cover": "http://i0.hdslb.com/bfs/archive/baae2b4050363c0ab45465b7cf696b8304fdaca8.jpg", + "upper": { + "mid": 412466388, + "name": "热门菌", + "face": "" + }, + "cover_type": 2, + "intro": "", + "ctime": 1563394571, + "mtime": 1563394571, + "state": 0, + "fav_state": 0, + "media_count": 55 + }, { + "id": 381779121, + "fid": 3817791, + "mid": 7792521, + "attr": 22, + "title": "鬼畜小课堂", + "cover": "http://i2.hdslb.com/bfs/archive/09a668cfdb38fb3a85f905c10f48a2947e36a695.jpg", + "upper": { + "mid": 7792521, + "name": "还有一天就放假了", + "face": "" + }, + "cover_type": 2, + "intro": "", + "ctime": 1553700224, + "mtime": 1557291666, + "state": 0, + "fav_state": 0, + "media_count": 25 + }] + } +} +``` + +
+
+### 查询用户发布的课程列表
+
+> https://api.bilibili.com/pugv/app/web/season/page
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|---------|-----|-------|
+| mid | num | 目标用户mid | 必要 | |
+| pn | num | 页码 | 非必要 | 默认为1 |
+| ps | num | 每页项数 | 非必要 | 默认为20 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|---------|-----|------|------------------------------------------|
+| code | num | 返回值 | 0：成功-400：请求错误
53013：用户隐私设置未公开 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|------|-------|------|-----| +| list | array | 课程列表 | | +| page | obj | 页面信息 | | + +`data`中的`page`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|------|---------|----------------------------| +| next | bool | 是否存在下一页 | false：最后一页
true：存在下一页 | +| num | num | 当前页码 | | +| size | num | 每页项数 | | +| total | num | 总计项数 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|---------|---------------| +| 0 | obj | 课程1 | | +| n | obj | 课程（n+1） | 按照目标用户的发布顺序排列 | +| …… | obj | …… | | + +`data`中的`list`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|-----------|-----|---------|----------| +| cover | str | 课程封面url | | +| ep_count | num | 课程集数 | | +| link | str | 课程页面url | 手机版页面url | +| page | num | 1 | 作用尚不明确 | +| play | num | 课程播放数 | | +| season_id | num | 课程ssid | | +| status | str | 更新状态说明 | | +| subtitle | str | 课程副标题 | | +| title | str | 课程标题 | | + +**示例：** + +查询用户`mid=33683045`的课程发布列表 + +```shell +curl -G 'https://api.bilibili.com/pugv/app/web/season/page' \ +--data-urlencode 'mid=33683045' \ +--data-urlencode 'ps=5' \ +--data-urlencode 'pn=1' +``` + +
+
+
+## 订阅
+
+查看响应示例：
+ +```json +{ + "code": 0, + "data": { + "items": [ + { + "cover": "http://i0.hdslb.com/bfs/archive/596575057885fff7f0ceff047437186cba459358.jpg", + "ep_count": 10, + "link": "https://m.bilibili.com/cheese/play/ss80", + "page": 1, + "play": 174467, + "season_id": 80, + "status": "共10期", + "subtitle": "百科全书式军事科普短视频系列", + "title": "《战忽知道》第一季" + }, + { + "cover": "http://i0.hdslb.com/bfs/archive/322aa94d27cece62d2a859caf71ac2426f29eee2.jpg", + "ep_count": 1, + "link": "https://m.bilibili.com/cheese/play/ss145", + "page": 1, + "play": 22155, + "season_id": 145, + "status": "更新至第1期", + "subtitle": "此课程为《局座：第四次工业革命来了》部分集数，请谨慎购买", + "title": "【体验课】局座讲5G：5G如何改变我们的生活？" + }, + { + "cover": "http://i0.hdslb.com/bfs/archive/b9794ac4507f8764e219df413b661b5faf499a19.jpg", + "ep_count": 10, + "link": "https://m.bilibili.com/cheese/play/ss113", + "page": 1, + "play": 49833, + "season_id": 113, + "status": "更新至第10期", + "subtitle": "百科全书式军事科普短视频系列", + "title": "《战忽知道》第二季" + }, + { + "cover": "http://i0.hdslb.com/bfs/archive/7351fcb33592a4bc7aac9f71d421b4b5ce0177d3.jpg", + "ep_count": 10, + "link": "https://m.bilibili.com/cheese/play/ss51", + "page": 1, + "play": 4981037, + "season_id": 51, + "status": "共10期", + "subtitle": "洞悉国际局势，学习战略思维", + "title": "局座的国际战略课" + }, + { + "cover": "http://i0.hdslb.com/bfs/archive/31e2a170b5a815e34f0537a2727b28f1b87dca18.jpg", + "ep_count": 10, + "link": "https://m.bilibili.com/cheese/play/ss121", + "page": 1, + "play": 30754, + "season_id": 121, + "status": "更新至第10期", + "subtitle": "百科全书式军事科普短视频系列", + "title": "《战忽知道》第三季" + } + ], + "page": { + "next": true, + "num": 1, + "size": 5, + "total": 8 + } + }, + "message": "success" +} +``` + +
+
+### 查询用户追番预览列表
+
+> https://space.bilibili.com/ajax/Bangumi/getList
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+如设置隐私查看自己的需要认证
+
+带有转义，且只能获取最多15条
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|---------|-----|-----|
+| mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|--------|--------------------|----------------------|-----------------------|
+| status | bool | 状态 | false：失败true：成功 | +| data | 失败：str
成功：obj | 失败：错误信息
成功：信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|--------|-------|--------|--------| +| count | num | 总计追番数 | | +| pages | num | 0 | 作用尚不明确 | +| result | array | 追番预览列表 | | + +`data`中的`result`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|---------|---------------| +| 0 | obj | 追番1 | | +| n | obj | 追番（n+1） | 按照目标用户的关注顺序排列 | +| …… | obj | …… | | +| 14 | obj | 追番15 | 最后一项 | + +`data`中的`result`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|-----------------|-----|-----------|-----------------------| +| brief | str | 简介 | | +| cover | str | 封面图片url | | +| evaluate | str | 空 | | +| favorites | num | 追番数 | | +| is_finish | num | 是否已完结 | 0：未完结
1：已完结 | +| last_ep_index | num | 0 | 作用尚不明确 | +| newest_ep_index | num | 最新一话 | 可能为0 | +| season_id | str | 番剧ssid | | +| share_url | str | 播放页面链接url | | +| title | str | 标题 | | +| total_count | num | 总计集数 | 未完结：-1
已完结：非0正整数 | + +**示例：** + +查看用户`mid=14082`的追番预览列表 + +```shell +curl -G 'https://space.bilibili.com/ajax/Bangumi/getList' \ +--data-urlencode 'mid=14082' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 查询用户追番（追剧）明细
+
+> https://api.bilibili.com/x/space/bangumi/follow/list
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+如设置隐私查看自己的需要认证
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------|-----|---------|-----|----------------|
+| vmid | num | 目标用户mid | 必要 | |
+| pn | num | 页码 | 非必要 | 默认为1 |
+| ps | num | 每页项数 | 非必要 | 默认为15 定义域1-30 |
+| type | num | 查询类型 | 必要 | 1：追番查看响应示例：
+ +```json +{ + "status": true, + "data": { + "count": 25, + "pages": 0, + "result": [{ + "season_id": "29310", + "share_url": "http:\/\/bangumi.bilibili.com\/anime\/29310\/", + "title": "异度侵入 ID:INVADED", + "is_finish": 1, + "favorites": 3479220, + "newest_ep_index": 13, + "last_ep_index": 0, + "total_count": 13, + "cover": "http:\/\/i0.hdslb.com\/bfs\/bangumi\/image\/9bf9e66968f85b33ec3769a16c86b36dc984abbc.png", + "evaluate": "", + "brief": "本片讲述利用能检测出人们杀意的装置以及利用思想粒子做出的“井”，来探知事件真相的科幻故事。" + }, { + "season_id": "25739", + "share_url": "http:\/\/bangumi.bilibili.com\/anime\/25739\/", + "title": "关于我转生变成史莱姆这档事", + "is_finish": 1, + "favorites": 5518829, + "newest_ep_index": 0, + "last_ep_index": 0, + "total_count": 27, + "cover": "https:\/\/i0.hdslb.com\/bfs\/bangumi\/a4c0e0ccc44fe3949a734f546cf5bb07da925bad.png", + "evaluate": "", + "brief": "史莱姆生活，开始了。\n上班族的三上悟在道路上被歹徒给刺杀身亡后，回过神来发现自己转生到了异世界。\n不..." + }, + ………… + ] + } +} +``` + +2：追剧 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|------------------------------------------| +| code | num | 返回值 | 0：成功
-400：请求错误
53013：用户隐私设置未公开 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-------|-------|-----| +| list | array | 追番列表 | | +| pn | num | 当前页码 | | +| ps | num | 每页项数 | | +| total | num | 总计追番数 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|---------|---------------| +| 0 | obj | 追番1 | | +| n | obj | 追番（n+1） | 按照目标用户的关注顺序排列 | +| …… | obj | …… | | + +`data`中的`list`数组中的对象： + +基本同「番剧详细信息」中的result对象（未完工） + +**示例：** + +查看用户`mid=14082`的追番明细 + +```shell +curl -G 'https://api.bilibili.com/x/space/bangumi/follow/list' \ +--data-urlencode 'vmid=14082' \ +--data-urlencode 'type=1' \ +--data-urlencode 'ps=2' \ +--data-urlencode 'pn=1' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 查询用户关注的TAG（话题）
+
+> https://space.bilibili.com/ajax/tags/getSubList
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）
+
+如设置隐私查看自己的需要认证
+
+带有转义
+
+只显示前100个
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|-----|-----|---------|-----|-----|
+| mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+|--------|----------------------|------------------------|-----------------------|
+| ststus | bool | 返回值 | false：错误查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [{ + "season_id": 29310, + "media_id": 28224080, + "season_type": 1, + "season_type_name": "番剧", + "title": "异度侵入 ID:INVADED", + "cover": "http://i0.hdslb.com/bfs/bangumi/image/9bf9e66968f85b33ec3769a16c86b36dc984abbc.png", + "total_count": 13, + "is_finish": 1, + "is_started": 1, + "is_play": 1, + "badge": "会员专享", + "badge_type": 0, + "rights": { + "allow_review": 1, + "is_selection": 1, + "selection_style": 1 + }, + "stat": { + "follow": 3475768, + "view": 87500861, + "danmaku": 1334654, + "reply": 316632, + "coin": 835150, + "series_follow": 3475242, + "series_view": 87500861 + }, + "new_ep": { + "id": 307774, + "index_show": "全13话", + "cover": "http://i0.hdslb.com/bfs/archive/3dce2b856a7b0ea667aa288b51b7c0478fa56c4d.jpg", + "title": "13", + "long_title": "CHANNELEDⅡ", + "pub_time": "2020-03-23 00:30:00", + "duration": 1481000 + }, + "rating": { + "score": 9.8, + "count": 262589 + }, + "square_cover": "http://i0.hdslb.com/bfs/bangumi/image/664dbf039ec2da8dd982b697a108e28e87b9897e.jpg", + "season_status": 13, + "season_title": "TV", + "badge_ep": "会员", + "media_attr": 196608, + "season_attr": 0, + "evaluate": "本片讲述利用能检测出人们杀意的装置以及利用思想粒子做出的“井”，来探知事件真相的科幻故事。...", + "areas": [{ + "id": 2, + "name": "日本" + }], + "subtitle": "", + "first_ep": 307446, + "can_watch": 1, + "series": { + "series_id": 4760, + "title": "ID:INVADED", + "season_count": 1, + "new_season_id": 29310 + }, + "publish": { + "pub_time": "2020-01-06 00:30:00", + "pub_time_show": "敬请期待", + "release_date": "2020-01-06", + "release_date_show": "2020年1月6日" + }, + "mode": 2, + "section": [{ + "section_id": 39327, + "season_id": 29310, + "limit_group": 328, + "watch_platform": 15, + "copyright": "dujia", + "ban_area_show": 1 + }, { + "section_id": 39633, + "season_id": 29310, + "limit_group": 328, + "watch_platform": 15, + "type": 1, + "copyright": "dujia", + "title": "其他", + "ban_area_show": 1 + }, { + "section_id": 44101, + "season_id": 29310, + "limit_group": 316, + "watch_platform": 15, + "type": 4, + "copyright": "ugc", + "ban_area_show": 1 + }], + "url": "https://www.bilibili.com/bangumi/play/ss29310", + "follow_status": 2, + "is_new": 0, + "progress": "", + "both_follow": true + }, { + "season_id": 25739, + "media_id": 139252, + "season_type": 1, + "season_type_name": "番剧", + "title": "关于我转生变成史莱姆这档事", + "cover": "http://i0.hdslb.com/bfs/bangumi/a4c0e0ccc44fe3949a734f546cf5bb07da925bad.png", + "total_count": 27, + "is_finish": 1, + "is_started": 1, + "is_play": 1, + "badge": "会员专享", + "badge_type": 0, + "rights": { + "allow_review": 1, + "is_selection": 1, + "selection_style": 1 + }, + "stat": { + "follow": 5516519, + "view": 246739631, + "danmaku": 3802465, + "reply": 460225, + "coin": 1338958, + "series_follow": 5516535, + "series_view": 246739631 + }, + "new_ep": { + "id": 316957, + "index_show": "全27话", + "cover": "http://i0.hdslb.com/bfs/archive/81d07d1a478ce3a6209b557e14df9b9c78c42abb.jpg", + "title": "OAD03", + "long_title": "外传：利姆鲁的华丽教师生活 其一", + "pub_time": "2020-03-27 00:00:03", + "duration": 1493000 + }, + "rating": { + "score": 9.4, + "count": 83354 + }, + "square_cover": "http://i0.hdslb.com/bfs/bangumi/8d9f5b4a566d0547bc2e3f6f733b732a09c0d3d4.jpg", + "season_status": 13, + "season_title": "TV", + "badge_ep": "会员", + "media_attr": 0, + "season_attr": 0, + "evaluate": "史莱姆生活，开始了。\n上班族的三上悟在道路上被歹徒给刺杀身亡后，回过神来发现自己转生到了异世界。\n不过，自己居然是“史莱姆”！\n他在得到利姆鲁这个名字后开始了自己的史莱姆人生，随着与各个种族相处交流的...", + "areas": [{ + "id": 2, + "name": "日本" + }], + "subtitle": "", + "first_ep": 250460, + "can_watch": 1, + "series": { + "series_id": 4188, + "title": "关于我转生变成史莱姆这档事", + "season_count": 1, + "new_season_id": 25739 + }, + "publish": { + "pub_time": "2018-10-02 00:30:00", + "pub_time_show": "2018年10月02日00:30", + "release_date": "2018-10-02", + "release_date_show": "2018年10月2日" + }, + "mode": 2, + "section": [{ + "section_id": 34988, + "season_id": 25739, + "limit_group": 328, + "watch_platform": 15, + "copyright": "bilibili", + "ban_area_show": 1 + }], + "url": "https://www.bilibili.com/bangumi/play/ss25739", + "follow_status": 2, + "is_new": 0, + "progress": "", + "both_follow": true + }], + "pn": 1, + "ps": 2, + "total": 25 + } +} +``` + +true：正确 | +| data | 错误时：str
正确时：obj | 错误时：错误信息
正确时：数据本体 | 正确时不返回错误信息 | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +|-------|-------|---------|-----| +| tags | array | 关注TAG列表 | | +| count | num | 关注TAG的数 | | + +`data`中的`tags`数组： + +| 项 | 类型 | 内容 | 备注 | +|-----|-----|------------|------| +| 0 | obj | 关注TAG1 | | +| n | obj | 关注TAG（n+1） | | +| …… | obj | …… | …… | +| 99 | obj | 关注TAG100 | 最后一项 | + +`data`中的`tags`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +|---------------|-----|---------------------|--------| +| archive_count | num | 0 | 作用尚不明确 | +| cover | str | TAG图片url | 无则为空 | +| name | str | TAG名 | | +| notify | num | 1 | 作用尚不明确 | +| tag_id | num | tag_id | | +| updated_ts | str | 1970-01-01 08:00:00 | 作用尚不明确 | + +**示例：** + +查询用户`mid=2`的关注TAG + +```shell +curl -G 'https://space.bilibili.com/ajax/tags/getSubList' \ +--data-urlencode 'mid=2' \ +-b 'SESSDATA=xxx' +``` + +
+
diff --git a/docs/user/status_number.md b/docs/user/status_number.md
new file mode 100644
index 0000000000..ec56fe3d82
--- /dev/null
+++ b/docs/user/status_number.md
@@ -0,0 +1,311 @@
+# 用户状态数
+
+- [关系状态数](#关系状态数)
+- [UP主状态数](#UP主状态数)
+- [~~订阅&投稿状态数（已弃用）~~](#~~订阅&投稿状态数（已弃用）~~)
+- [相簿投稿数](#相簿投稿数)
+
+---
+
+## 关系状态数
+> https://api.bilibili.com/x/relation/stat
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| vmid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "status": true, + "data": { + "tags": [{ + "name": "豪宅", + "cover": "", + "tag_id": 47637, + "notify": 1, + "archive_count": 0, + "updated_ts": "1970-01-01 08:00:00" + }, { + "name": "死亡搁浅", + "cover": "", + "tag_id": 1737239, + "notify": 1, + "archive_count": 0, + "updated_ts": "1970-01-01 08:00:00" + }, + ………… + ], + "count": 58 + } +} +``` + +-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | ----------- | ----------------------------------------------- | +| mid | num | 目标用户mid | | +| following | num | 关注数 | | +| whisper | num | 悄悄关注数 | 需要登录(Cookie或APP)
未登录或非自己恒为0 | +| black | num | 黑名单数 | 需要登录(Cookie或APP)
未登录或非自己恒为0 | +| follower | num | 粉丝数 | | + +**示例：** + +查询用户`mid=332704117`的关系状态数 + +```shell +curl -G 'https://api.bilibili.com/x/relation/stat' \ +--data-urlencode 'vmid=332704117' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## UP主状态数
+
+> https://api.bilibili.com/x/space/upstat
+
+*请求方式：GET*
+
+认证方式：Cookie（SESSDATA）或APP
+
+注：该接口需要**任意用户**登录，否则**不会返回任何数据**
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 332704117, + "following": 32, + "whisper": 0, + "black": 0, + "follower": 919515 + } +} +``` + +-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | ---------- | ----- | +| archive | obj | 视频播放量 | | +| article | obj | 专栏阅读量 | | +| likes | num | 获赞次数 | | + +`data`中的`archive`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ----- | ---------- | ----- | +| view | num | 视频播放量 | | + +`data`中的`article`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ----- | ---------- | ----- | +| view | num | 专栏阅读量 | | + +**示例：** + +查询用户`mid=456664753`的UP主状态数 + +```shell +curl -G 'https://api.bilibili.com/x/space/upstat' \ +--data-urlencode 'mid=456664753' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## ~~订阅&投稿状态数（已弃用）~~
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "archive": { + "view": 213567370 + }, + "article": { + "view": 3230808 + }, + "likes": 20295095 + } +} +``` + +
+
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ----- | ---------- | ------------ | +| video | num | 投稿视频数 | | +| bangumi | num | 追番数 | 无视隐私设置 | +| cinema | num | 追剧数 | 无视隐私设置 | +| channel | obj | 频道数 | | +| favourite | obj | 收藏夹数 | 无视隐私设置 | +| tag | num | 关注TAG数 | 无视隐私设置 | +| article | num | 投稿专栏数 | | +| playlist | num | 0 | 作用尚不明确 | +| album | num | 投稿相簿数 | | +| audio | num | 投稿音频数 | | +| pugv | num | 投稿课程数 | | + +`data`中的`channel`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | ---------- | ------------ | +| master | num | 频道数 | | +| guest | num | 频道数 | | + +`data`中的`favourite`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ------------ | --------------------------------------- | +| master | num | 全部收藏夹数 | 需要登录(SESSDATA)
只能查看自己的 | +| guest | num | 公开收藏夹数 | 无视隐私设置 | + +**示例：** + +查询用户`mid=239202390`的订阅&投稿状态数 + +```shell +curl -G 'https://api.bilibili.com/x/space/navnum' \ +--data-urlencode 'mid=239202390' \ +-b 'SESSDATA=xxx' +``` + +
+
+## 相簿投稿数
+
+> https://api.vc.bilibili.com/link_draw/v1/doc/upload_count
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ---- |
+| uid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------- |
+| code | num | 返回值 | 0：成功 |
+| msg | str | 错误信息 | 默认为success |
+| message | str | 错误信息 | 默认为success |
+| data | obj | 信息本体 | |
+
+`data`对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ---- | ---------------------- | ------------------ |
+| all_count | num | 相簿总数 | 总数为以下三者之和 |
+| draw_count | num | 发布绘画数 | |
+| photo_count | num | 发布摄影数 | |
+| daily_count | num | 发布日常（图片动态）数 | |
+
+**示例：**
+
+ 查询用户`mid=53456`的投稿相簿数
+
+```shell
+curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/upload_count' \
+--data-urlencode 'uid=53456'
+```
+
+查看折叠内容
+> https://api.bilibili.com/x/space/navnum + +*请求方式：GET* + +**url参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ----------- | ------ | ---- | +| mid | num | 目标用户mid | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------- | +| code | num | 返回值 | 0：成功-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ----- | ---------- | ------------ | +| video | num | 投稿视频数 | | +| bangumi | num | 追番数 | 无视隐私设置 | +| cinema | num | 追剧数 | 无视隐私设置 | +| channel | obj | 频道数 | | +| favourite | obj | 收藏夹数 | 无视隐私设置 | +| tag | num | 关注TAG数 | 无视隐私设置 | +| article | num | 投稿专栏数 | | +| playlist | num | 0 | 作用尚不明确 | +| album | num | 投稿相簿数 | | +| audio | num | 投稿音频数 | | +| pugv | num | 投稿课程数 | | + +`data`中的`channel`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | ---------- | ------------ | +| master | num | 频道数 | | +| guest | num | 频道数 | | + +`data`中的`favourite`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ------------ | --------------------------------------- | +| master | num | 全部收藏夹数 | 需要登录(SESSDATA)
只能查看自己的 | +| guest | num | 公开收藏夹数 | 无视隐私设置 | + +**示例：** + +查询用户`mid=239202390`的订阅&投稿状态数 + +```shell +curl -G 'https://api.bilibili.com/x/space/navnum' \ +--data-urlencode 'mid=239202390' \ +-b 'SESSDATA=xxx' +``` + +
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "video": 290, + "bangumi": 25, + "cinema": 13, + "channel": { + "master": 2, + "guest": 2 + }, + "favourite": { + "master": 6, + "guest": 6 + }, + "tag": 0, + "article": 1, + "playlist": 0, + "album": 150, + "audio": 4, + "pugv": 0 + } +} +``` + +
+
diff --git a/docs/video/action.md b/docs/video/action.md
new file mode 100644
index 0000000000..db733cec1f
--- /dev/null
+++ b/docs/video/action.md
@@ -0,0 +1,830 @@
+# 视频点赞&投币&收藏&分享
+
+- [视频点赞&投币&收藏&分享](#视频点赞投币收藏分享)
+ - [点赞](#点赞)
+ - [点赞视频（web端）](#点赞视频web端)
+ - [点赞视频（APP端）](#点赞视频app端)
+ - [判断视频是否被点赞（双端）](#判断视频是否被点赞双端)
+ - [点踩](#点踩)点赞
+ - [点踩视频（APP端）](#点踩视频app端)
+ - [投币](#投币)
+ - [投币视频（web端）](#投币视频web端)
+ - [投币视频（APP端）](#投币视频app端)
+ - [判断视频是否被投币（双端）](#判断视频是否被投币双端)
+ - [收藏](#收藏)
+ - [收藏视频（双端）](#收藏视频双端)
+ - [判断视频是否被收藏（双端）](#判断视频是否被收藏双端)
+ - [一键三连](#一键三连)
+ - [一键三连视频（web端）](#一键三连视频web端)
+ - [一键三连视频（APP端）](#一键三连视频app端)
+ - [分享](#分享)
+ - [分享视频 （Web端）](#分享视频-web端)
+
+---
+
+## 点赞
+
+查看响应示例：
+ +```json +{ + "code":0, + "msg":"success", + "message":"success", + "data":{ + "all_count":92, + "draw_count":5, + "photo_count":0, + "daily_count":87 + } +} +``` + +
+
+### 点赞视频（web端）
+
+> https://api.bilibili.com/x/web-interface/archive/like
+
+*请求方式：POST*
+
+认证方式：仅可Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------------ | ---------------------- |
+| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
+| like | num | 操作方式 | 必要 | 1：点赞2：取消赞 | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | +| code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
65004：取消点赞失败
65006：重复点赞 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +点赞视频`av79677524`/`BV1uJ411r7hL` + +avid方式： + +```shell +curl 'https://api.bilibili.com/x/web-interface/archive/like' \ +--data-urlencode 'aid=79677524' \ +--data-urlencode 'like=1' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +bvid方式： + +```shell +curl 'https://api.bilibili.com/x/web-interface/archive/like' \ +--data-urlencode 'bvid=BV1uJ411r7hL' \ +--data-urlencode 'like=1' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 点赞视频（APP端）
+
+> https://app.bilibili.com/x/v2/view/like
+
+*请求方式：POST*
+
+认证方式：仅可APP
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 稿件avid | 必要 | |
+| like | num | 操作方式 | 必要 | 0：点赞查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + +1：取消赞 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------------------------------------------------------- | +| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
10003：不存在该稿件 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 数据本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ------------ | ---- | +| toast | str | 提示信息内容 | | + +**示例：** + +点赞视频`av79677524` + +```shell +curl 'https://app.bilibili.com/x/v2/view/like' \ +--data-urlencode 'access_key=xxx' \ +--data-urlencode 'aid=79677524' \ +--data-urlencode 'like=0' +``` + +
+
+
+### 判断视频是否被点赞（双端）
+
+> https://api.bilibili.com/x/web-interface/archive/has/like
+
+*请求方式：GET*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ------------ | ------------------ |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | ---------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "toast": "点赞收到！视频可能推荐哦" + } +} +``` + +-400：请求错误
-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | num | 被点赞标志 | 0：未点赞
1：已点赞 | + +**示例：** + +视频`av39330059`/`BV1Bt411z799`的状态为已点赞 + +avid方式： + +```shell +curl -G 'https://api.bilibili.com/x/web-interface/archive/has/like' \ +--data-urlencode 'aid=39330059' \ +-b 'SESSDATA=xxx' +``` + +bvid方式： + +```shell +curl -G 'api.bilibili.com/x/web-interface/archive/has/like' \ +--data-urlencode 'bvid=BV1Bt411z799' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 点踩
+
+### 点踩视频（App端）
+
+> https://app.biliapi.net/x/v2/view/dislike
+
+*请求方式：POST*
+
+认证方式：仅可App
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|------------|-----|-----------|-----|-----------------|
+| access_key | str | APP Token | 必要 | |
+| aid | num | 视频aid | 必要 | |
+| dislike | num | 操作类型 | 必要 | 0：点踩查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": 1 +} +``` + +1：取消点踩 | + +**json回复：** + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|-----------------------------------------------------------------------------------------| +| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
-404：啥都木有
65005：取消踩失败 未点踩过
65007：已踩过 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | + +**示例：** + +点踩视频 + +```shell +curl -L -X POST 'https://app.biliapi.net/x/v2/view/dislike' \ +-H 'Content-Type: application/x-www-form-urlencoded' \ +--data-urlencode 'access_key=xxx' \ +--data-urlencode 'aid=xxx' \ +--data-urlencode 'dislike=0' +``` + +取消点踩 + +```shell +curl -L -X POST 'https://app.biliapi.net/x/v2/view/dislike' \ +-H 'Content-Type: application/x-www-form-urlencoded' \ +--data-urlencode 'access_key=xxx' \ +--data-urlencode 'aid=xxx' \ +--data-urlencode 'dislike=1' +``` + +## 投币 + +
+
+
+### 投币视频（web端）
+
+> https://api.bilibili.com/x/web-interface/coin/add
+
+*请求方式：POST*
+
+认证方式：仅可Cookie（SESSDATA）
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------------------ | ------------ | --------------------------------------- |
+| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
+| multiply | num | 投币数量 | 必要 | 上限为2 |
+| select_like | num | 是否附加点赞 | 非必要 | 0：不点赞1：同时点赞
默认为0 | +| csrf | str | CSRF Token（位于cookie） | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-104：硬币不足
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
34002：不能给自己投币
34003：非法的投币数量
34004：投币间隔太短
34005：超过投币上限 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ----------------------------------------------------- | +| like | bool | 是否点赞成功 | true：成功
false：失败
已赞过则附加点赞失败 | + +**示例：** + +为视频`av90671873`/`BV1N7411A7wC`投币2枚 + +avid方式： + +```shell +curl 'https://api.bilibili.com/x/web-interface/coin/add' \ +--data-urlencode 'aid=90671873' \ +--data-urlencode 'select_like=1' \ +--data-urlencode 'multiply=2' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +bvid方式： + +```shell +curl 'https://api.bilibili.com/x/web-interface/coin/add' \ +--data-urlencode 'bvid=BV1N7411A7wC' \ +--data-urlencode 'select_like=1' \ +--data-urlencode 'multiply=2' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 投币视频（APP端）
+
+> https://app.bilibili.com/x/v2/view/coin/add
+
+*请求方式：POST*
+
+认证方式：仅可APP
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ----------- | ---- | ------------ | ----------- | --------------------------------------- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 稿件avid | 必要 | |
+| multiply | num | 投币数量 | 必要 | 上限为2 |
+| select_like | num | 附加点赞 | 非必要 | 0：不点赞查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "like": true + } +} +``` + +1：同时点赞
默认为0 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-104：硬币不足
-400：请求错误
10003：不存在该稿件
34002：不能给自己投币
34003：非法的投币数量
34004：投币间隔太短
34005：超过投币上限 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ----------------------------------------------------- | +| like | bool | 是否点赞成功 | true：成功
false：失败
已赞过则附加点赞失败 | + +为视频`av90671873`投币2枚 + +```shell +curl 'https://app.bilibili.com/x/v2/view/coin/add' \ +--data-urlencode 'access_key=xxx' \ +--data-urlencode 'aid=90671873' \ +--data-urlencode 'select_like=1' \ +--data-urlencode 'multiply=2' +``` + +
+
+
+### 判断视频是否被投币（双端）
+
+> https://api.bilibili.com/x/web-interface/archive/coins
+
+*请求方式：GET*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ------------ | ------------------ |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "like": true + } +} +``` + +-400：请求错误
-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | -------- | --------- | +| multiply | num | 投币枚数 | 未投币为0 | + +**示例：** + +视频`av37896701`/`BV18t411q7zz`的投币数为2枚 + +avid方式： + +```shell +curl -G 'api.bilibili.com/x/web-interface/archive/coins' \ +--data-urlencode 'aid=37896701' \ +-b 'SESSDATA=xxx' +``` + +bvid方式： + +```shell +curl -G 'api.bilibili.com/x/web-interface/archive/coins' \ +--data-urlencode 'bvid=BV18t411q7zz' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 收藏
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "multiply": 2 + } +} +``` + +
+
+### 收藏视频（双端）
+
+> https://api.bilibili.com/medialist/gateway/coll/resource/deal
+>
+> https://api.bilibili.com/x/v3/fav/resource/deal
+
+*请求方式：POST*
+
+认证方式：APP或Cookie（SESSDATA）
+
+鉴权方式：Cookie方式时需要验证referer为 `.bilibili.com`域名下
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------------- | ---- | ------------------------ | -------------- | ------------------------------ |
+| access_key | str | APP登录Token | APP方式必要 | |
+| rid | num | 稿件avid | 必要 | |
+| type | num | 必须为2 | 必要 | |
+| add_media_ids | nums | 需要加入的收藏夹mlid | 非必要 | 同时添加多个，用`,`（%2C）分隔 |
+| del_media_ids | nums | 需要取消的收藏夹mlid | 非必要 | 同时取消多个，用`,`（%2C）分隔 |
+| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| code | num | 返回值 | 0：成功-101：账号未登录
-111：csrf校验失败
-400：请求错误
-403：访问权限不足
10003：不存在该稿件
11201：已经收藏过了
11202：已经取消收藏了
11203：达到收藏上限
72010017：参数错误 | +| message | str | 错误信息 | 正确为success | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | -------------------- | ----------------------- | +| prompt | bool | 是否为未关注用户收藏 | false：否
true：是 | + +**示例：** + +将视频`av49166435`添加到收藏夹`49166435`中 + +Cookie方式： + +```shell +curl 'https://api.bilibili.com/medialist/gateway/coll/resource/deal' \ +--data-urlencode 'rid=90671873' \ +--data-urlencode 'type=2' \ +--data-urlencode 'add_media_ids=49166435' \ +--data-urlencode 'del_media_ids=' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' \ +-e 'https://www.bilibili.com' +``` + +APP方式： + +```shell +curl 'https://api.bilibili.com/medialist/gateway/coll/resource/deal' \ +--data-urlencode 'access_key=xxx' \ +--data-urlencode 'rid=90671873' \ +--data-urlencode 'type=2' \ +--data-urlencode 'add_media_ids=49166435' \ +--data-urlencode 'del_media_ids=' +``` + +
+
+
+### 判断视频是否被收藏（双端）
+
+> https://api.bilibili.com/x/v2/fav/video/favoured
+
+*请求方式：GET*
+
+认证方式：APP或Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | -------- | ------------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num或str | 稿件avid或稿件bvid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "data": { + "prompt": false + }, + "message": "success" +} +``` + +-400：请求错误
-101：账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +data 对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | -------- | ------------------------------- | +| count | num | 1 | 作用尚不明确 | +| favoured | bool | 是否收藏 | true：已收藏
false：未收藏 | + +**示例：** + +视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏 + +avid方式： + +```shell +curl -G 'https://api.bilibili.com/x/v2/fav/video/favoured' \ +--data-urlencode 'aid=46281123' \ +-b 'SESSDATA=xxx' +``` + +bvid方式： + +```shell +curl -G 'https://api.bilibili.com/x/v2/fav/video/favoured' \ +--data-urlencode 'aid=BV1Bb411H7Dv' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+## 一键三连
+
+查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "count": 1, + "favoured": true + } +} +``` + +
+
+### 一键三连视频（web端）
+
+> https://api.bilibili.com/x/web-interface/archive/like/triple
+
+*请求方式：POST*
+
+认证方式：仅可Cookie（SESSDATA）
+
+同时点赞投币收藏视频，收藏于默认收藏夹中
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------------ | ------------------ |
+| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | -------------------------------------------------------------------------------------------------- |
+| code | num | 返回值 | 0：成功-101：账号未登录
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ------------ | --------------------------- | +| like | bool | 是否点赞成功 | true：成功
false：失败 | +| coin | bool | 是否投币成功 | true：成功
false：失败 | +| fav | bool | 是否收藏成功 | true：成功
false：失败 | +| multiply | num | 投币枚数 | 默认为2 | + +**示例：** + +将视频`av91003840`/`BV1Wj411f79U`一键三连 + +avid方式： + +```shell +curl 'https://api.bilibili.com/x/web-interface/archive/like/triple' \ +--data-urlencode 'aid=91003840' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +bvid方式： + +```shell +curl 'https://api.bilibili.com/x/web-interface/archive/like/triple' \ +--data-urlencode 'bvid=BV1Wj411f79U' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +``` + +
+
+
+### 一键三连视频（APP端）
+
+> https://app.bilibili.com/x/v2/view/like/triple
+
+*请求方式：POST*
+
+认证方式：仅可APP
+
+同时点赞投币收藏视频，收藏于默认收藏夹中
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ----------- | ---- |
+| access_key | str | APP登录Token | APP方式必要 | |
+| aid | num | 稿件avid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | -------------------------------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "like": true, + "coin": true, + "fav": true, + "multiply": 2 + } +} +``` + +-101：账号未登录
-400：请求错误
10003：不存在该稿件 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ------------ | --------------------------- | +| like | bool | 是否点赞成功 | true：成功
false：失败 | +| coin | bool | 是否投币成功 | true：成功
false：失败 | +| fav | bool | 是否收藏成功 | true：成功
false：失败 | +| multiply | num | 投币枚数 | 默认为2 | + +**示例：** + +将视频`av91003840`一键三连 + +```shell +curl 'https://app.bilibili.com/x/v2/view/like/triple' \ +--data-urlencode 'access_key=xxx' \ +--data-urlencode 'aid=91003840' +``` + +
+
+
+## 分享
+
+### 分享视频 （Web端）
+
+> https://api.bilibili.com/x/web-interface/share/add
+
+*请求方式：POST*
+
+认证方式 csrf token
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------------ | ------------ | ------------------ |
+| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
+| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
+| csrf | str | CSRF Token（位于cookie） | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | ---------- | ------------------------------------------------------------------------- |
+| code | num | 返回值 | 0：成功查看响应示例：
+ +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "like": true, + "coin": true, + "fav": true, + "multiply": 2 + } +} +``` + +-101：账号未登录
-111：csrf校验失败
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | num | 当前分享数 | | + + +**示例：** + +分享视频`BV1oA411776z` + +```shell +curl 'https://api.bilibili.com/x/web-interface/share/add' \ +--data-urlencode 'csrf=xxx' \ +--data-urlencode 'bvid=BV1oA411776z' +``` + +
+
diff --git a/docs/video/appeal.md b/docs/video/appeal.md
new file mode 100644
index 0000000000..f3b4e65e9f
--- /dev/null
+++ b/docs/video/appeal.md
@@ -0,0 +1,306 @@
+# 稿件投诉
+
+---
+
+- [附件上传](#附件上传)
+- [获取投诉类型](#获取投诉类型)
+- [投诉稿件](#投诉稿件)
+
+---
+
+## 附件上传
+
+> 附件上传与视频封面上传共用一个api。
+
+## 获取投诉类型
+
+> https://api.bilibili.com/x/web-interface/archive/appeal/tags
+
+*请求类型：GET*
+
+**json回复：**
+
+| 参数名 | 类型 | 内容 | 备注 |
+| ------- | ------------- | ---- | ------- |
+| code | num | | 成功为0 |
+| message | str | | 成功为0 |
+| ttl | num | 1 | |
+| data | List\