Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge branch 'master' of https://github.com/SocialSisterYi/bilibili-API-collect

Browse Source
This commit is contained in:
SessionHu 2025-05-20 22:47:10 +08:00
commit ffcbff63a7
No known key found for this signature in database
GPG Key ID: 9E7E64C25FE3301A
19 changed files with 4477 additions and 2457 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
README.md
View File

@ -92,9 +92,9 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
- [x] [Web 端 Cookie 刷新](docs/login/cookie_refresh.md)
- [ ] [消息中心](docs/message)
- [ ] [通知类消息](docs/message/msg.md)
- [ ] [私信](docs/message/private_msg.md)
- [ ] [私信消息类型、内容说明](docs/message/private_msg_content.md)
- [ ] 设置
- [x] [私信](docs/message/private_msg.md)
- [x] [私信消息类型、内容说明](docs/message/private_msg_content.md)
- [x] [设置](docs/message/settings.md)
- [ ] [用户](docs/user)
- [x] [基本信息](docs/user/info.md)
- [x] [状态数](docs/user/status_number.md)
@ -386,6 +386,7 @@ OR Aifadian：[https://afdian.com/@ShakaiAneE](https://afdian.com/@ShakaiAneE)
- [CzJam/Bili_Realtime_Data](https://github.com/CzJam/Bili_Realtime_Data): Bilibili粉丝与视频实时数据统计
- [kingwingfly/fav](https://github.com/kingwingfly/fav): 自动同步bili收藏夹、合集视频到本地的CLI工具（Rust实现，并提供一个文档测试完善的Rust风格的用于构建有状态爬虫的核心库）
- [linyuye/Bilibili_crawler](https://github.com/linyuye/Bilibili_crawler): 基于bilibili懒加载api爬取b站动态，视频等评论区
- [ouzexi/bilibili-hot-tags](https://github.com/ouzexi/bilibili-hot-tags): 一个B站热门视频标签检索统计小工具
### 其他

4
assets/zone_v2_icon/rural.svg
View File

@ -12,6 +12,6 @@
d="M19.80106 14.7049C19.08797 18.83357 13.92499 19.93133 11.03338 16.8288C12.60778 12.48394 16.91021 12.22205 19.80106 14.7049z"
fill="#57D587ff"></path>
<path
d="M11.74896 19.16765C10.6297 16.4353 10.36675 8.92814 15.46522 6.13969"
fill="#000000ff"></path>
d="M16.30752 5.67904C16.56192 6.14421 16.39104 6.72755 15.92592 6.98196C13.72982 8.183 12.6264 10.43021 12.22214 12.83395C11.81539 15.25277 12.15562 17.6279 12.63734 18.80381C12.83827 19.29446 12.60346 19.8551 12.1128 20.05603C11.62224 20.25706 11.0616 20.02224 10.86058 19.53158C10.22304 17.97514 9.87216 15.2304 10.32874 12.51552C10.78781 9.78549 12.10214 6.88484 15.00461 5.29743C15.46973 5.04302 16.05312 5.21388 16.30752 5.67904z"
fill="#1F9F81ff"></path>
</svg>
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 927 B

After

Width:  |  Height:  |  Size: 1.3 KiB

6
docs/blackroom/jury/judgement_info.md
View File

@ -167,6 +167,12 @@
**示例：**
```shell
curl -G 'https://api.bilibili.com/x/credit/v2/jury/case/info' \
--data-urlencode 'case_id=AC2SiaD8jlrL' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>

2
docs/dynamic/detail.md
View File

@ -18,7 +18,7 @@
| timezone_offset | num | -480 | 非必要 | |
| platform | str | 平台 | 非必要 | `web` |
| gaia_source | str | 来源 | 非必要 | `main_web` |
| features | str | 功能 | 非必要 | `itemOpusStyle,opusBigCover,onlyfansVote,endFooterHidden,decorationCard,onlyfansAssetsV2,ugcDelete,onlyfansQaCard,commentsNewVersion`, 参见 [图文 功能模块](../opus/features.md) |
| features | str | 功能 | 必要 | `itemOpusStyle,opusBigCover,onlyfansVote,endFooterHidden,decorationCard,onlyfansAssetsV2,ugcDelete,onlyfansQaCard,commentsNewVersion`, 参见 [图文 功能模块](../opus/features.md) |
| web_location | str | `333.1368` | 非必要 | |
| x-bili-device-req-json | obj | 设备信息? | 非必要 | `{"platform":"web","device":"pc"}` |
| x-bili-web-req-json | obj | 请求信息? | 非必要 | `{"spm_id":"333.1368"}` |

43
docs/electric/charge_list.md
View File

@ -2,7 +2,7 @@
## 获取空间充电公示列表
> https://api.bilibili.com/x/ugcpay-rank/elec/month/up
> <https://api.bilibili.com/x/ugcpay-rank/elec/month/up>
*请求方式：GET*
@ -120,7 +120,7 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
## 获取视频充电鸣谢名单
> https://api.bilibili.com/x/web-interface/elec/show
> <https://api.bilibili.com/x/web-interface/elec/show>
*请求方式:GET*
@ -161,25 +161,36 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------ | ---------------- |
| show | bool | 是否展示视频充电鸣谢名单 | |
| state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通高档、自定义充电 |
| state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通包月高档、自定义充电 |
| title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` |
| jump_url | str | 跳转url | |
| icon | str | 充电图标 | |
| high_level | obj | 高档充电信息 | |
| high_level | obj | 充电专属视频信息 | |
| with_qa_id | num | 充电问答id | |
`show_info`中的`high_level`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ------------------------ | ---------------- |
| privilege_type | num | | |
| title | str | | |
| sub_title | str | | |
| show_button | bool | | |
| button_text | str | | |
| jump_url | obj | | |
| intro | str | | |
| open | bool | | |
| new | bool | | |
| -------------- | ---- | ------------------------------ | ---------------- |
| privilege_type | num | 解锁视频所需最低定价档位的代码 | 见[充电档位代码与定价](../electric/monthly.md#充电档位代码privilege_type与定价) |
| title | str | 提示标题 | `该视频为「{充电档位名称}」专属视频` |
| sub_title | str | 提示子标题 | `开通「{充电档位定价}元档包月充电」即可观看` |
| show_button | bool | 是否显示按钮 | |
| button_text | str | 按钮文本 | `去开通` |
| jump_url | obj | 跳转url信息 | 详细信息有待补充 |
| intro | str | 充电介绍语 | |
| open | bool | （？） | |
| new | bool | （？） | |
| question_text | str | （？） | |
| qa_detail_link | str | （？） | |
`high_level`中的`jump_url`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------------------- | ---- |
| up_link | str | UP主包月充电购买页面url | |
| paywall_link | str | 视频试看后的提示页面url | |
| previewbar_link | str | 视频预览页面url | |
`data`中的`list`数组：
@ -296,7 +307,7 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
## 查询我收到的充电列表
> https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord
> <https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord>
*请求方式：GET*
@ -432,7 +443,7 @@ curl -G 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord' \
## 查询历史充电数据
> https://member.bilibili.com/x/h5/elec/rank/recent
> <https://member.bilibili.com/x/h5/elec/rank/recent>
*请求方式：GET*

244
docs/electric/monthly.md
View File

@ -22,7 +22,7 @@
## 获取包月充电列表
> https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord
> <https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord>
*请求方式：GET*
@ -75,7 +75,7 @@
| item | array | 充电详情 | |
| start | num | 开始充电时间 | 秒级时间戳 |
| high_level_state | num | 是否可对UP主进行高档充电 | |
| elec_reply_state | num | 是否可对UP主进行专属问答 | 0：否<br />1：是<br />2：（？） |
| elec_reply_state | num | 是否可对UP主进行专属问答 | 0：否<br />1：是<br />2：状态未知 |
数组`list`中的对象中的`item`数组：
@ -85,7 +85,6 @@
| n | obj | 充电档位(n+1) | |
| …… | obj | …… | …… |
数组`item`中的对象：
| 字段 | 类型 | 内容 | 备注 |
@ -111,13 +110,12 @@
| signed_price | num | 下次续费金额 | 单位为千分之一元人民币 |
| pay_channel | num | 签约平台 | 2：微信支付<br />4：支付宝 |
| period | num | 下次充电天数 | |
| mobile_app | num | 充电渠道 | 可为`android`等 |
| mobile_app | str | 充电渠道 | 可为`android`等 |
**示例：**
获取自己正在使用的包月充电的列表
```shell
curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
--data-urlencode 'page=1' \
@ -231,7 +229,6 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
}
```
</details>
表示自己从2022-11-23 14:10:04开始给“2233”包月充电，并且在2022-12-21 18:35:21在微信开通了连续包年充电，在2023-12-22 00:00:00的时候会自动续费36元，并继续充电366天；
@ -240,7 +237,7 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
## UP主包月充电详情
> https://api.bilibili.com/x/upower/item/detail
> <https://api.bilibili.com/x/upower/item/detail>
*请求方式：GET*
@ -255,8 +252,8 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />203101：UP主未开通包月充电功能 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
@ -264,10 +261,16 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------- | ---- |
| ------------------ | ---- | -------------------------- | ------------------------------ |
| upower_rank | obj | 充电详情 | |
| item | obj | 充电欢迎语 | |
| item | obj | 充电欢迎语信息 | |
| user_card | obj | UP主信息 | |
| upower_level | num | UP主开通的充电等级 | 1：非高档充电<br />2：高档充电 |
| elec_reply_state | num | 是否可对UP主进行专属问答 | |
| voucher_state | obj | 包月充电券信息 | **详细信息有待补充** |
| upower_right_count | obj | 不同充电档位下的充电权益数 | |
| only_contain_medal | bool | 享有的权益仅为粉丝勋章 | |
| privilege_type | num | 当前给该UP主包月充电的档位 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价)，若从未给该UP主包月充电过则为0 |
`data`中的`upower_rank`对象：
@ -280,12 +283,12 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
`upower_rank`中的`list`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| ---- | ---- | --------- | -------------------------- |
| 0 | obj | 用户1 | |
| n | obj | 用户(n+1) | 按照充电时间排序 |
| n | obj | 用户(n+1) | 按照最初充电时间排序（？） |
| …… | obj | …… | …… |
数组`list`中的对象：
`list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | --------------- | ---- |
@ -308,14 +311,19 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
| avatar | str | UP主头像url | |
| nickname | str | UP主昵称 | |
`data`中的`upower_right_count`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | -------------------- | ---- |
| {充电档位代码} | num | 该档位下的充电权益数 | |
**示例：**
获取`mid=293793435`的包月充电详情
获取`mid=1265680561`的包月充电详情
```shell
curl 'https://api.bilibili.com/x/upower/item/detail' \
--data-urlencode 'up_mid=293793435' \
--data-urlencode 'up_mid=1265680561' \
-b 'SESSDATA=xxx'
```
@ -329,14 +337,26 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
"ttl": 1,
"data": {
"upower_rank": {
"total": 1,
"total_desc": "1+",
"total": 5082,
"total_desc": "5000+",
"list": [
{
"rank": 1,
"mid": 425503913,
"nickname": "晨叶梦春",
"avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg"
"mid": 1476475459,
"nickname": "一只屑椒",
"avatar": "https://i1.hdslb.com/bfs/face/dc721da215f4651e0472d566b146ee8fdf198dbe.jpg"
},
{
"rank": 2,
"mid": 275365317,
"nickname": "-陪我去看海吧i",
"avatar": "https://i0.hdslb.com/bfs/face/dd7547b13020e7f47549ad7908fd3fc58efadefc.jpg"
},
{
"rank": 3,
"mid": 401909111,
"nickname": "Vege5able",
"avatar": "https://i2.hdslb.com/bfs/face/46b1fdc94c7851ec0c47817adeec13e3225da559.jpg"
}
]
},
@ -345,9 +365,29 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
"welcomes": "哈喽b站的小伙伴们，我的充电计划升级啦！ 感兴趣就多多支持我吧~(゜-゜)つロ"
},
"user_card": {
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"nickname": "社会易姐QwQ"
}
"avatar": "https://i1.hdslb.com/bfs/face/5ddddba98f0265265662a8f7d5383e528a98412b.jpg",
"nickname": "永雏塔菲"
},
"upower_level": 1,
"elec_reply_state": 1,
"voucher_state": {
"voucher_order_id": "95843e812210c455d1ea6e4714bf105a00",
"user_voucher_state": 2,
"vip_action": 0,
"voucher_name": "包月充电券（6元档）",
"validate_price": 0,
"validate_level": 0,
"activity": "",
"common_time": 0,
"high_level_time": 0,
"specify_up": 0,
"specify_level": 0
},
"upower_right_count": {
"10": 3
},
"only_contain_medal": false,
"privilege_type": 0
}
}
```
@ -356,7 +396,7 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
## 与UP主的包月充电关系
> https://api.bilibili.com/x/upower/charge/follow/info
> <https://api.bilibili.com/x/upower/charge/follow/info>
*请求方式：GET*
@ -382,14 +422,18 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ---- | ------------------------ | ------------------------------------------- |
| ------------------ | ---- | ------------------------------ | ------------------------------------------- |
| days | num | 已保持多少天包月充电状态 | |
| up_card | obj | UP主信息 | |
| user_card | obj | 自己的信息 | |
| remain_days | num | 剩余天数 | 未处于包月充电状态为-1 |
| remain_less_1day | num | 剩余的天数小于1天 | 0：否<br />1：是<br />未处于包月充电状态为0 |
| remain_less_1day | num | 剩余的天数是否小于1天 | 0：否<br />1：是<br />未处于包月充电状态为0 |
| upower_rank | obj | 充电详情 | |
| upower_icon | str | 充电图标url | 仅在处于包月充电状态时有内容 |
| upower_right_count | obj | 当前自己享有该UP主的充电权益数 | |
| only_contain_medal | bool | 享有的权益仅为粉丝勋章 | |
| privilege_type | num | 当前给该UP主包月充电的档位代码 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价)，若未处于包月充电状态为0 |
| challenge_info | obj | 充电挑战信息 | **详细信息有待补充** |
`data`中的`up_card`对象：
@ -436,7 +480,6 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
获取与`mid=293793435`的包月充电关系
```shell
curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
--data-urlencode 'up_mid=293793435' \
@ -477,7 +520,23 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
}
]
},
"upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png"
"upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png",
"upower_right_count": 2,
"only_contain_medal": false,
"privilege_type": 10,
"challenge_info": {
"challenge_id": "",
"description": "",
"challenge_type": 0,
"remaining_days": 0,
"end_time": "",
"progress": 0,
"targets": [],
"state": 0,
"end_time_unix": 0,
"pub_dyn": 0,
"dyn_content": ""
}
}
}
```
@ -488,7 +547,7 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
## 包月充电用户排名
> https://api.bilibili.com/x/upower/up/member/rank/v2
> <https://api.bilibili.com/x/upower/up/member/rank/v2>
*请求方式：GET*
@ -497,10 +556,11 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | -------- |
| -------------- | ---- | ------------ | ------ | --------- |
| up_mid | num | 目标用户mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为20 |
| pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 必要 | 最大为101 |
| pn | num | 页码 | 必要 | |
| privilege_type | num | 充电档位代码 | 非必要 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价)，默认为可以显示排名的档位中**最高定价**的档位 |
**json回复：**
@ -516,21 +576,26 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | ------------ | ---- |
| -------------- | ----- | ------------------------------ | -------- |
| up_info | obj | UP主信息 | |
| rank_info | array | 充电用户排名 | |
| user_info | obj | 自己的信息 | |
| member_total | num | 充电用户总数 | |
| rank_info | array | 当前档位的充电用户排名 | |
| user_info | obj | 自己在该档位下与UP主的充电关系 | |
| member_total | num | 当前档位的充电用户总数 | |
| privilege_type | num | 当前充电档位代码 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价) |
| is_charge | bool | 自己是否给该UP主包月充电过 | 无论档位 |
| tabs | array | 可显示排名的充电档位代码列表 | |
| level_info | array | 可显示排名的充电档位信息 | |
`data`中的`up_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------ | ---------------------------------------- |
| ------------ | ---- | -------------------- | ---------------------------------------- |
| mid | num | UP主mid | |
| nickname | str | UP主昵称 | |
| avatar | str | UP主头像url | |
| type | num | UP主认证类型 | -1：无<br />0：UP主认证<br />1：机构认证 |
| title | str | UP主认证文字 | |
| upower_state | num | UP主充电功能开启状态 | 0：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通包月高档、自定义充电 |
`data`中的`rank_info`数组：
@ -559,18 +624,45 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
| mid | num | 用户mid | |
| nickname | str | 用户昵称 | |
| avatar | str | 用户头像url | |
| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 |
| rank | num | 包月充电排名 | 不在该充电档位用户列表里为-1 |
| day | num | 包月充电天数 | |
| expire_at | num | 包月充电过期时间 | 秒级时间戳，若从未给UP主包月充电为0 |
| remain_days | num | 未过期时：剩余天数<br />已过期且之前给UP主包月充电过：自过期以来的天数 | |
| expire_at | num | 包月充电过期时间 | 秒级时间戳，若从未给UP主在该档位下包月充电过为0 |
| remain_days | num | 剩余天数 | 若该档位充电状态已失效为0 |
`data`中的`tabs`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---------------- |
| 0 | num | 档位代码1 | |
| n | num | 档位代码(n+1) | |
| …… | num | …… | …… |
`data`中的`level_info`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 档位1 | |
| n | obj | 档位(n+1) | |
| …… | obj | …… | …… |
`level_info`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | -------------------- | ---------------------- |
| privilege_type | num | 当前充电档位代码 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价) |
| name | str | 档位名称 | |
| price | num | 档位价格 | 单位为百分之一元人民币 |
| member_total | num | 当前档位的用户总数 | |
**示例：**
获取给`mid=293793435`包月充电的用户排名
获取给`mid=686127`包月充电的用户排名
```shell
curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
--data-urlencode 'up_mid=293793435' \
--data-urlencode 'up_mid=686127' \
--data-urlencode 'ps=3' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
@ -584,19 +676,38 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
"ttl": 1,
"data": {
"up_info": {
"mid": 293793435,
"nickname": "社会易姐QwQ",
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"type": -1,
"title": ""
"mid": 686127,
"nickname": "籽岷",
"avatar": "https://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp",
"type": 0,
"title": "2024百大UP主、知名游戏UP主",
"upower_state": 3
},
"rank_info": [
{
"mid": 425503913,
"nickname": "晨叶梦春",
"avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg",
"mid": 187012867,
"nickname": "是我灬不配",
"avatar": "https://i1.hdslb.com/bfs/face/ad4d2ce0705fd766a0ade315f5a6a5984ce479f4.jpg",
"rank": 1,
"day": 31,
"day": 682,
"expire_at": 0,
"remain_days": 0
},
{
"mid": 20135495,
"nickname": "和平时一样鸽",
"avatar": "https://i2.hdslb.com/bfs/face/0eef725964105f39b1f000a59f232d9094017544.jpg",
"rank": 2,
"day": 620,
"expire_at": 0,
"remain_days": 0
},
{
"mid": 490065730,
"nickname": "乔治Y-GYhaha",
"avatar": "https://i1.hdslb.com/bfs/face/e1753e1e43d7a7df5333c5a2f4d3ec1d0334ebe6.jpg",
"rank": 3,
"day": 527,
"expire_at": 0,
"remain_days": 0
}
@ -605,12 +716,29 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
"mid": 425503913,
"nickname": "晨叶梦春",
"avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg",
"rank": 1,
"day": 31,
"expire_at": 1678723199,
"remain_days": 15
"rank": -1,
"day": 0,
"expire_at": 0,
"remain_days": 0
},
"member_total": 1
"member_total": 46881,
"privilege_type": 50,
"is_charge": false,
"tabs": [50, 10],
"level_info": [
{
"privilege_type": 50,
"name": "审稿",
"price": 12800,
"member_total": 1082
},
{
"privilege_type": 10,
"name": "石粒",
"price": 600,
"member_total": 46158
}
]
}
}
```

299
docs/live/manage.md
View File

@ -78,7 +78,7 @@ curl 'https://api.live.bilibili.com/xlive/app-blink/v1/preLive/CreateRoom' \
## 更新直播间标题
## 更新直播间信息
> https://api.live.bilibili.com/room/v1/Room/update
@ -92,10 +92,15 @@ curl 'https://api.live.bilibili.com/xlive/app-blink/v1/preLive/CreateRoom' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | -------------------- |
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
| title | str | 直播间标题 | | 最大20字符 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| csrf_token | str | CSRF Token（位于 cookie） | | |
| csrf_token | str | CSRF Token（位于 cookie） | 非必要 | |
| platform | str | 平台标识 | 非必要 | |
| visit_id | str | (?) | 非必要 | 某种标识？ |
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
| title | str | 直播间标题 | 非必要 | 上限40个字符 |
| area\_id | num | 直播分区id（子分区id） | 非必要 | 详见[直播分区](live_area.md) |
| add\_tag | str | 要添加的标签 | 非必要 | 开播设置界面上限10个字符 |
| del\_tag | str | 要删除的标签 | 非必要 | 若存在`add_tag`时不起作用 |
**json回复：**
@ -103,10 +108,26 @@ curl 'https://api.live.bilibili.com/xlive/app-blink/v1/preLive/CreateRoom' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />65530：token错误（登录错误）<br />1：错误 |
| code | num | 返回值 | 0：成功<br />-1：操作太频繁<br />1：错误<br />3：未登录或鉴权失败<br />405：不允许的请求方法<br />60009：分区已下线<br />65530：token错误（登录错误）<br /> |
| msg | str | 错误信息 | 默认为ok |
| message | str | 错误信息 | 默认为ok |
| data | array | 空 | |
| data | obj | 信息本体 | 部分失败情况下是`[]`（空数组） |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---- | ---- |
| sub_session_key | str | 信息变动标识 | |
| audit_info | obj | 标题审核信息 | |
`data`中的`audit_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------ | ---- | ---- | ---- |
| audit_title_reason | str | 标题审核提示 | |
| audit_title_status | num | 标题审核状态 | |
| audit_title | str | 被审核的标题 | 更新标题时存在 |
| update_title | str | `""` | 作用尚不明确 |
**示例：**
@ -128,7 +149,108 @@ curl 'https://api.live.bilibili.com/room/v1/Room/update' \
"code":0,
"msg":"ok",
"message":"ok",
"data": []
"data":{
"sub_session_key":"",
"audit_info":{
"audit_title_reason":"先发后审",
"update_title":"",
"audit_title_status":2,
"audit_title":"测试"
}
}
}
```
</details>
修改直播间`10352053`分区为`40`
```shell
curl 'https://api.live.bilibili.com/room/v1/Room/update' \
--data-urlencode 'room_id=10352053' \
--data-urlencode 'area_id=40' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;bili_jct=xx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "ok",
"message": "ok",
"data": {
"sub_session_key": "",
"audit_info": {
"audit_title_reason": "",
"update_title": "",
"audit_title_status": 0
}
}
}
```
</details>
给直播间`11996900`添加一个标签为`测试标签`
```shell
curl 'https://api.live.bilibili.com/room/v1/Room/update' \
--data-urlencode 'room_id=11996900' \
--data-urlencode 'add_tag=测试标签' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;bili_jct=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "ok",
"message": "ok",
"data": {
"sub_session_key": "",
"audit_info": {
"audit_title_reason": "",
"update_title": "",
"audit_title_status": 0
}
}
}
```
</details>
给直播间`11996900`删除内容为`测试标签`的标签
```shell
curl 'https://api.live.bilibili.com/room/v1/Room/update' \
--data-urlencode 'room_id=11996900' \
--data-urlencode 'del_tag=测试标签' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;bili_jct=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "ok",
"message": "ok",
"data": {
"sub_session_key": "",
"audit_info": {
"audit_title_reason": "",
"update_title": "",
"audit_title_status": 0
}
}
}
```
@ -152,7 +274,7 @@ curl 'https://api.live.bilibili.com/room/v1/Room/update' \
| -------- | ---- | ------------------------ | ------ | ----------------------------------- |
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
| area_v2 | num | 直播分区id（子分区id） | 必要 | 详见[直播分区](live_area.md) |
| platform | str | 直播平台 | 必要 | 直播姬（pc）：pc_link<br />web端：<br />bililink：android_link |
| platform | str | 直播平台 | 必要 | 直播姬（pc）：pc_link<br />web在线直播：web_link<br />bililink：android_link |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
@ -171,13 +293,19 @@ curl 'https://api.live.bilibili.com/room/v1/Room/update' \
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | ---------------- | ---------------------- |
| change | num | 是否改变状态 | 0：未改变<br />1：改变 |
| status | str | LIVE | |
| status | str | 直播间状态 | `LIVE` |
| room_type | num | 0 | 作用尚不明确 |
| rtmp | obj | RTMP推流地址信息 | |
| protocols | array | ？？？ | 作用尚不明确 |
| try_time | str | ？？？ | 作用尚不明确 |
| live_key | str | ？？？ | 作用尚不明确 |
| live_key | str | 标记直播场次的key | |
| sub_session_key | str | 信息变动标识 | |
| notice | obj | ？？？ | 作用尚不明确 |
| qr | str | `""` | 作用尚不明确 |
| need_face_auth | bool | 需要人脸识别? | 作用尚不明确 |
| service_source | str | ？？？ | 作用尚不明确 |
| rtmp\_backup | null | ？？？ | 作用尚不明确 |
| up_stream_extra | obj | 主播推流额外信息? | |
`data`中的`rtmp`对象：
@ -215,6 +343,12 @@ curl 'https://api.live.bilibili.com/room/v1/Room/update' \
| button_text | str | 空 | 作用尚不明确 |
| button_url | str | 空 | 作用尚不明确 |
`data`中的`up_stream_extra`对象：
| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| isp | str | 主播的互联网服务提供商 | |
**示例：**
以`27`作为分区id开播直播间`10352053`
@ -238,29 +372,28 @@ curl 'https://api.live.bilibili.com/room/v1/Room/startLive' \
```json
{
"code": 0,
"msg": "",
"message": "",
"data":{
"change": 1,
"status": "LIVE",
"try_time": "0000-00-00 00:00:00",
"room_type": 0,
"live_key": "608336837537435443",
"sub_session_key": "608336837537435443sub_time:1747292297",
"rtmp":{
"addr": "rtmp://txy.live-send.acg.tv/live-txy/",
"code": "?streamname=live_293793435_1567354&key=***",
"new_link": "http://tcdns.myqcloud.com:8086/bilibili_redirect?up_rtmp=txy.live-send.acg.tv%2Flive-txy%2F%3Fstreamname%3Dlive_293793435_1567354%26key%3D***",
"provider": "txy"
"type": 1,
"addr": "rtmp://live-push.bilivideo.com/live-bvc/",
"code": "?streamname=live_348892132_32373699\u0026key=e03061d4a7529d8eaa322dc4d330ca1c\u0026schedule=rtmp\u0026pflag=11",
"new_link": "https://core.bilivideo.com/video/uplinkcore/selfbuild/schedule?up_rtmp=live-push.bilivideo.com%2Flive-bvc%2F%3Fstreamname%3Dlive_348892132_32373699%26key%3De73061d8a7539d8eaa233dc4d880ca1c%26schedule%3Drtmp%26pflag%3D11\u0026edge=edge",
"provider": "live"
},
"protocols":[
{
"protocol": "rtmp",
"addr": "rtmp://txy.live-send.acg.tv/live-txy/",
"code": "?streamname=live_293793435_1567354&key=***",
"new_link": "http://tcdns.myqcloud.com:8086/bilibili_redirect?up_rtmp=txy.live-send.acg.tv%2Flive-txy%2F%3Fstreamname%3Dlive_293793435_1567354%26key%3D***",
"addr": "rtmp://live-push.bilivideo.com/live-bvc/","code":"?streamname=live_348892132_32373699\u0026key=e73061d4a1002d8eaa322dc4d880ca1c\u0026schedule=rtmp\u0026pflag=11",
"new_link": "https://core.bilivideo.com/video/uplinkcore/selfbuild/schedule?up_rtmp=live-push.bilivideo.com%2Flive-bvc%2F%3Fstreamname%3Dlive_348892132_32373699%26key%3De10298d4a7539d8eaa322dc4d220ca1c%26schedule%3Drtmp%26pflag%3D11\u0026edge=edge",
"provider": "txy"
}
],
"try_time": "0000-00-00 00:00:00",
"live_key": "l:one:live:record:10352053:1589344980",
"notice":{
"type": 1,
"status": 0,
@ -268,8 +401,17 @@ curl 'https://api.live.bilibili.com/room/v1/Room/startLive' \
"msg": "",
"button_text": "",
"button_url": ""
},
"qr": "",
"need_face_auth": false,
"service_source": "live-streaming",
"rtmp_backup": null,
"up_stream_extra":{
"isp": "电信"
}
}
},
"message": "",
"msg": ""
}
```
@ -308,7 +450,7 @@ curl 'https://api.live.bilibili.com/room/v1/Room/startLive' \
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ---------------------- |
| change | num | 是否改变状态 | 0：未改变<br />1：改变 |
| status | str | PREPARING | |
| status | str | 直播间状态 | `PREPARING`、`ROUND` |
**示例：**
@ -397,114 +539,3 @@ curl 'https://api.live.bilibili.com/xlive/app-blink/v1/index/updateRoomNews' \
```
</details>
## 编辑直播间标签
> https://api.live.bilibili.com/room/v1/Room/update
*请求方式：POST*
认证方式：Cookie（SESSDATA）
鉴权方式：Cookie中`bili_jct`的值正确并与`csrf`相同
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | -------------------- |
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
| add_tag | str | 要添加的标签 | 必要 | 最大10个字符 |
| del_tag | str | 要删除的标签 | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| csrf_token | str | CSRF Token（位于 cookie） | | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />65530：token错误（登录错误）<br />1：错误 |
| data | obj | | |
| message | str | 错误信息 | 默认为ok |
| msg | str | 错误信息 | 默认为ok |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ---- | ---- |
| audit_info | obj | | |
| sub_session_key | str | | |
`data`中的`audit_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------ | ---- | ---- | ---- |
| audit_title_reason | str | | |
| audit_title_status | num | 0 | |
| update_title | str | | |
**示例：**
给直播间`11996900`添加一个标签为`测试标签`
```shell
curl 'https://api.live.bilibili.com/room/v1/Room/update' \
--data-urlencode 'room_id=11996900' \
--data-urlencode 'add_tag=测试标签' \
--data-urlencode 'csrf_token=xxx' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;bili_jct=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "ok",
"message": "ok",
"data": {
"sub_session_key": "",
"audit_info": {
"audit_title_reason": "",
"update_title": "",
"audit_title_status": 0
}
}
}
```
</details>
给直播间`11996900`删除内容为`测试标签`的标签
```shell
curl 'https://api.live.bilibili.com/room/v1/Room/update' \
--data-urlencode 'room_id=11996900' \
--data-urlencode 'del_tag=测试标签' \
--data-urlencode 'csrf_token=xxx' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx;bili_jct=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "ok",
"message": "ok",
"data": {
"sub_session_key": "",
"audit_info": {
"audit_title_reason": "",
"update_title": "",
"audit_title_status": 0
}
}
}
```
</details>

20
docs/login/login_notice.md
View File

@ -2,7 +2,7 @@
## 查询登录记录
> https://api.bilibili.com/x/safecenter/login_notice
> <https://api.bilibili.com/x/safecenter/login_notice>
*请求方式：GET*
@ -12,7 +12,7 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ------------------------------------------------------------ |
| mid | num | 用户mid | 必要 | |
| mid | num | 用户mid | 必要 | 必须为自己的mid |
| buvid | str | 设备虚拟id | 非必要 | web端为操作登录接口时Cookie中的`buvid3`<br />若登录设备无`buvid`则留空 |
**json回复：**
@ -21,7 +21,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />-403：访问权限不足 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
@ -71,7 +71,7 @@ curl -G 'https://api.bilibili.com/x/safecenter/login_notice' \
## 最近一周的登录情况
> https://api.bilibili.com/x/member/web/login/log
> <https://api.bilibili.com/x/member/web/login/log>
*请求方式: GET*
@ -114,7 +114,7 @@ curl -G 'https://api.bilibili.com/x/safecenter/login_notice' \
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------------- | ---- |
| ip | str | 登录 IP | 末两位以 `*` 打码 |
| ip | str | 登录 IP | IPv4：末 2 位以 `*` 打码<br />IPv6：末 5 位以 `*` 打码 |
| time | num | 登录时间 | UNIX 秒级时间戳 |
| time_at | str | 登录时间 | 格式为 `yyyy-MM-dd HH:mm:ss` |
| status | bool | 是否登录成功? | |
@ -139,8 +139,16 @@ curl -G "https://api.bilibili.com/x/member/web/login/log" \
"message": "0",
"ttl": 1,
"data": {
"count": 14,
"count": 15,
"list": [
{
"ip": "240e:*:*:*:*:*:*:*",
"time": 1746038055,
"time_at": "2025-05-01 02:34:15",
"status": true,
"type": 0,
"geo": "中国广西梧州电信"
},
{
"ip": "108.181.*.*",
"time": 1722036741,

5
docs/message/msg.md
View File

@ -2,8 +2,9 @@
## 获取未读消息数
> https://api.bilibili.com/x/msgfeed/unread
> https://api.vc.bilibili.com/x/im/web/msgfeed/unread (新接口)
> <https://api.bilibili.com/x/msgfeed/unread>
> <https://api.vc.bilibili.com/x/im/web/msgfeed/unread> (新接口)
*请求方式：GET*

1043
docs/message/private_msg.md
View File

File diff suppressed because it is too large Load Diff

18
docs/message/private_msg_content.md
View File

@ -28,7 +28,7 @@
在发送私信时，请确保下面的对象合法且 `url` 项的值为 B 站的图床 url，否则会报 21037 `图片格式不合法，不要调戏接口啦` 错误
建议设置 `height` 与 `width` 属性，否则可能会导致消息显示异常
建议设置 `height` 与 `width` 属性为图片的尺寸，否则可能会导致消息显示异常
根对象：
@ -167,8 +167,8 @@
**按钮显示逻辑说明：**
- **按钮的url：**首先尝试读取 `jump_uri_config`、`jump_uri_2_config`、`jump_uri_3_config` 对象中表示当前设备类型的 url（如 `web_uri`、`android_uri` 等）；若为空值，则尝试读取 `jump_uri_config`、`jump_uri_2_config`、`jump_uri_3_config` 对象中 `all_uri` 的值；若仍为空值，则读取根对象中 `jump_uri`、`jump_uri_2`、`jump_uri_3` 的值；若仍为空值，则不显示该按钮（无论提示文字是否为空）
- **按钮提示文字：**若按钮是可见的，则先尝试读取 `jump_uri_config`、`jump_uri_2_config`、`jump_uri_3_config` 对象中 `text` 的值；若为空值，则读取根对象中 `jump_text`、`jump_text_2`、`jump_text_3` 的值；若仍为空值，则提示文字为 `查看详情`
- **按钮的url**：首先尝试读取 `jump_uri_config`、`jump_uri_2_config`、`jump_uri_3_config` 对象中表示当前设备类型的 url（如 `web_uri`、`android_uri` 等）；若为空值，则尝试读取 `jump_uri_config`、`jump_uri_2_config`、`jump_uri_3_config` 对象中 `all_uri` 的值；若仍为空值，则读取根对象中 `jump_uri`、`jump_uri_2`、`jump_uri_3` 的值；若仍为空值，则不显示该按钮（无论提示文字是否为空）
- **按钮提示文字**：若按钮是可见的，则先尝试读取 `jump_uri_config`、`jump_uri_2_config`、`jump_uri_3_config` 对象中 `text` 的值；若为空值，则读取根对象中 `jump_text`、`jump_text_2`、`jump_text_3` 的值；若仍为空值，则提示文字为 `查看详情`
根对象：
@ -176,12 +176,12 @@
| ----------------- | ----- | ------------- | ------------------------- |
| title | str | 通知标题 | |
| text | str | 通知内容 | |
| jump_text | str | 按钮1提示文字 | 若按钮1不存在则为空；若按钮1存在此项也可能为空，此时前端显示文字为 `查看详情` |
| jump_text | str | 按钮1提示文字 | 若按钮1不存在则为空；若按钮1存在，此项也可能为空，此时前端显示文字为 `查看详情` |
| jump_uri | str | 按钮1跳转链接 | 若按钮1不存在则为空 |
| modules | 有效时：array<br />无效时：null | 详细信息 | |
| jump_text_2 | str | 按钮2提示文字 | 若按钮2不存在则为空；若按钮2存在此项也可能为空，此时前端显示文字为 `查看详情` |
| jump_text_2 | str | 按钮2提示文字 | 若按钮2不存在则为空；若按钮2存在，此项也可能为空，此时前端显示文字为 `查看详情` |
| jump_uri_2 | str | 按钮2跳转链接 | 若按钮2不存在则为空 |
| jump_text_3 | str | 按钮3提示文字 | 若按钮3不存在则为空；若按钮3存在此项也可能为空，此时前端显示文字为 `查看详情` |
| jump_text_3 | str | 按钮3提示文字 | 若按钮3不存在则为空；若按钮3存在，此项也可能为空，此时前端显示文字为 `查看详情` |
| jump_uri_3 | str | 按钮3跳转链接 | 若按钮3不存在则为空 |
| notifier | 有效时：obj<br />无效时：null | 发送者信息 | |
| jump_uri_config | obj | 按钮1配置 | |
@ -523,7 +523,7 @@
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------- |
| ------- | ---- | -------- | -------------------------- |
| content | str | 提示列表 | **经过序列化后**的JSON数组 |
`content`文本经JSON解析后的数组：
@ -602,8 +602,8 @@
根对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ---- |
| group_id | num | 粉丝团id | |
| -------- | ---- | -------- | ---------- |
| group_id | num | 粉丝团id | （非必要） |
| content | str | 提示文字 | |
**示例：**

830
docs/message/settings.md Normal file
View File

@ -0,0 +1,830 @@
# 消息设置
## 获取用户偏好设置
> <https://api.vc.bilibili.com/link_setting/v1/link_setting/get>
*请求方式：GET 或 POST*
认证方式：Cookie（SESSDATA）
**url参数（GET）或 正文参数（application/x-www-form-urlencoded，POST）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------------- | ---- | -------------------------------- | ------------ | ------------------------- |
| msg_notify | num | 是否显示 “消息提醒” 设置 | 非必要 | 若此项为任意整数，则返回数据中有 `msg_notify` 项 |
| show_unfollowed_msg | num | 是否显示 “收起未关注人消息” 设置 | 非必要 | 若此项为任意整数，则返回数据中有 `show_unfollowed_msg` 项 |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
| csrf_token | str | CSRF Token（位于cookie） | POST方式必要 | |
| csrf | str | CSRF Token（位于cookie） | POST方式必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
| msg | str | 错误信息 | 默认为0 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data` 对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------------------ | ---- | -------------------- | --------------------------------------------------------------------------- |
| show_unfollowed_msg | num | 收起未关注人消息 | 请求参数 `show_unfollowed_msg` 为整数时显示此项<br />0：不收起<br />1：收起 |
| msg_notify | num | 消息提醒 | 请求参数 `msg_notify` 为整数时显示此项<br />1：接收<br />3：不接收 |
| set_like | num | 收到的赞提醒（旧） | 0：接收<br />5：不接收 |
| set_comment | num | 回复我的提醒（旧） | 0：所有人<br />1：关注的人<br />2：不接受任何消息提醒 |
| set_at | num | @ 我的提醒 （旧） | 0：所有人<br />1：关注的人<br />2：不接受任何消息提醒 |
| is_group_fold | num | 收起应援团消息 | 0：不收起<br />1：收起 |
| should_receive_group | num | 接收应援团消息 | 0：不接收<br />1：接收 |
| receive_unfollow_msg | num | 接收未关注人消息 | 前端隐藏此开关<br />0：不接收<br />1：接收 |
| followed_reply | num | 被关注回复 | 0：关闭<br />1：开启 |
| keys_reply | num | 关键词回复 | 0：关闭<br />1：开启 |
| recv_reply | num | 收到消息回复 | 0：关闭<br />1：开启 |
| voyage_reply | num | 大航海上船回复 | 0：关闭<br />1：开启 |
| recommend_followed_reply | num | 被关注时自动推送作品 | 0：关闭<br />1：开启 |
| ai_intercept | num | 私信智能拦截 | 0：关闭<br />1：开启 |
| anti_harassment | null | 防骚扰和互动人群设置 | 此接口恒返回 `null` |
| set_recv_reply | num | 收到回复提醒（新） | 0：所有人<br />1：关注的人<br />2：不接受任何消息提醒 |
| set_recv_like | num | 收到喜欢提醒（新） | 0：接收<br />2：不接收 |
| set_new_follow | num | 新增粉丝提醒（新） | 0：接收<br />2：不接收 |
**示例：**
```shell
curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get' \
--data-urlencode 'msg_notify=1' \
--data-urlencode 'show_unfollowed_msg=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "0",
"message": "0",
"ttl": 1,
"data": {
"show_unfollowed_msg": 0,
"msg_notify": 1,
"set_like": 0,
"set_comment": 0,
"set_at": 0,
"is_group_fold": 0,
"should_receive_group": 1,
"receive_unfollow_msg": 1,
"followed_reply": 1,
"keys_reply": 0,
"recv_reply": 1,
"voyage_reply": 0,
"recommend_followed_reply": 1,
"ai_intercept": 1,
"anti_harassment": null,
"set_recv_reply": 0,
"set_recv_like": 0,
"set_new_follow": 0
}
}
```
</details>
## 修改用户偏好设置
> <https://api.vc.bilibili.com/link_setting/v1/link_setting/set>
*请求方式：POST*
认证方式：Cookie（SESSDATA）
参数名称与值基本同「[获取用户偏好设置](#获取用户偏好设置)」中的 `data` 对象，修改设置时只需提供修改的设置对应的参数即可
开启自动回复功能需要 1000 粉丝及以上，否则会提示 700009 `权限不足`
**正文参数（application/x-www-form-urlencoded）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------------------ | ---- | ------------------------ | ------ | ----------------------------------------------------- |
| show_unfollowed_msg | num | 收起未关注人消息 | 非必要 | 0：不收起<br />1：收起 |
| msg_notify | num | 消息提醒 | 非必要 | 1：接收<br />3：不接收 |
| set_like | num | 收到的赞提醒 | 非必要 | 0：接收<br />5：不接收 |
| set_comment | num | 回复我的提醒 | 非必要 | 0：所有人<br />1：关注的人<br />2：不接受任何消息提醒 |
| set_at | num | @ 我的提醒 | 非必要 | 0：所有人<br />1：关注的人<br />2：不接受任何消息提醒 |
| is_group_fold | num | 收起应援团消息 | 非必要 | 0：不收起<br />1：收起 |
| should_receive_group | num | 接收应援团消息 | 非必要 | 0：不接收<br />1：接收 |
| receive_unfollow_msg | num | 接收未关注人消息 | 非必要 | 0：不接收<br />1：接收 |
| followed_reply | num | 被关注回复 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
| keys_reply | num | 关键词回复 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
| recv_reply | num | 收到消息回复 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
| voyage_reply | num | 大航海上船回复 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
| recommend_followed_reply | num | 被关注时自动推送作品 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
| ai_intercept | num | 私信智能拦截 | 非必要 | 0：关闭<br />1：开启 |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
| csrf_token | str | CSRF Token（位于cookie） | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | -------------------------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />2：非法参数<br />700009：权限不足 |
| msg | str | 错误信息 | 默认为0 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 空对象 |
**示例：**
开启接收消息提醒
```shell
curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/set' \
--data-urlencode 'msg_notify=1' \
--data-urlencode 'build=0' \
--data-urlencode 'mobi_app=web' \
--data-urlencode 'csrf_token=xxx' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "0",
"message": "0",
"ttl": 1,
"data": {}
}
```
</details>
## 获取消息屏蔽词
> <https://api.vc.bilibili.com/x/im/link_setting/get_block_words>
*请求方式：GET*
认证方式：Cookie（SESSDATA）
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------- | ------ | ------------- |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
| msg | str | 错误信息 | 默认为0 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data` 对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------- | ------------------ | ---------------- |
| words | 有效时：array<br />无效时：null | 消息屏蔽词列表 | |
| message | str | （？） | **作用尚不明确** |
| max_word_length | num | 单个屏蔽词最大长度 | 目前为 `20` |
| max_words_size | num | 屏蔽词最大数量 | 目前为 `200` |
`data` 中的 `words` 数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---- |
| 0 | obj | 屏蔽词1 | |
| n | obj | 屏蔽词(n+1) | |
| …… | obj | …… | …… |
`words` 数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------------- | ---------- |
| content | str | 屏蔽词内容 | |
| ctime | num | 屏蔽词添加时间 | 秒级时间戳 |
**示例：**
```shell
curl -G 'https://api.vc.bilibili.com/x/im/link_setting/get_block_words' \
--data-urlencode 'build=0' \
--data-urlencode 'mobi_app=web' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "0",
"message": "0",
"ttl": 1,
"data": {
"words": [
{
"content": "屏蔽词",
"ctime": 1746422088
}
],
"message": "",
"max_word_length": 20,
"max_words_size": 200
}
}
```
</details>
## 添加消息屏蔽词
> <https://api.vc.bilibili.com/x/im/link_setting/add_block_word>
*请求方式：POST*
认证方式：Cookie（SESSDATA）
**正文参数（application/x-www-form-urlencoded）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | -------------- |
| content | str | 屏蔽词内容 | 必要 | 最多 20 个字符 |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
| csrf_token | str | CSRF Token（位于cookie） | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />1900004：添加失败，屏蔽词限制最多20个字<br />1900005：添加失败，最多可以添加200个屏蔽词<br />1900006：添加失败，屏蔽词重复<br />1900007：添加失败，屏蔽词不支持空格 |
| msg | str | 错误信息 | 默认为0 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 空对象 |
**示例：**
```shell
curl 'https://api.vc.bilibili.com/x/im/link_setting/add_block_word' \
--data-urlencode 'content=屏蔽词' \
--data-urlencode 'build=0' \
--data-urlencode 'mobi_app=web' \
--data-urlencode 'csrf_token=xxx' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "0",
"message": "0",
"ttl": 1,
"data": {}
}
```
</details>
## 删除消息屏蔽词
> <https://api.vc.bilibili.com/x/im/link_setting/del_block_word>
*请求方式：POST*
认证方式：Cookie（SESSDATA）
**正文参数（application/x-www-form-urlencoded）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | ------------- |
| content | str | 屏蔽词内容 | 必要 | |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
| csrf_token | str | CSRF Token（位于cookie） | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| msg | str | 错误信息 | 默认为0 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 空对象 |
**示例：**
```shell
curl 'https://api.vc.bilibili.com/x/im/link_setting/del_block_word' \
--data-urlencode 'content=屏蔽词' \
--data-urlencode 'build=0' \
--data-urlencode 'mobi_app=web' \
--data-urlencode 'csrf_token=xxx' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "0",
"message": "0",
"ttl": 1,
"data": {}
}
```
</details>
## 获取自动回复文本/关键词回复规则
> <https://api.vc.bilibili.com/x/im/auto_reply/get_reply_text>
*请求方式：GET*
认证方式：Cookie（SESSDATA）
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------- | ------ | ---------------------------------------------------------------------------- |
| type\[\] | num | 自动回复类型 | 必要 | 1：被关注回复<br />2：关键词回复<br />3：收到消息回复<br />5：大航海上船回复 |
| uid | num | 自己的mid | 非必要 | |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />2：非法参数 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data` 对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----- | ------------ | -------------------------------------- |
| texts | array | 自动回复文本 | 若未设置此类型自动回复文本，则没有此项 |
`data` 中的 `texts` 数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | -------------------------------- |
| 0 | obj | 文本1 | |
| n | obj | 文本(n+1) | 当类型为 “关键词回复” 时可有多项 |
| …… | obj | …… | …… |
`texts` 数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------- | -------------------------------------------------------------------------- |
| id | num | 自动回复规则id | |
| uid | num | 自己的mid | |
| type | num | 自动回复类型 | 同请求参数 `type[]` |
| title | str | 规则名称 | 当类型为 “关键词回复” 时有效，否则为空文本 |
| key1 | str | 精确匹配关键词 | 当类型为 “关键词回复” 时有效，否则为空文本<br />以中文逗号分隔每一个关键词 |
| key2 | str | 模糊匹配关键词 | 当类型为 “关键词回复” 时有效，否则为空文本<br />以中文逗号分隔每一个关键词 |
| reply | str | 回复内容 | |
**示例：**
获取关键词回复规则
```shell
curl -G 'https://api.vc.bilibili.com/x/im/auto_reply/get_reply_text' \
--data-urlencode 'type[]=2' \
--data-urlencode 'uid=425503913' \
--data-urlencode 'build=0' \
--data-urlencode 'mobi_app=web' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"texts": [
{
"id": 201321,
"uid": 425503913,
"type": 2,
"title": "谢谢",
"key1": "谢谢，Thank you",
"key2": "感谢",
"reply": "我也感谢您对我的支持 (=・ω・=)"
},
{
"id": 201320,
"uid": 425503913,
"type": 2,
"title": "哭2",
"key1": "哭",
"key2": "",
"reply": "我是不会哭的 (=・ω・=)"
},
{
"id": 201318,
"uid": 425503913,
"type": 2,
"title": "哭",
"key1": "",
"key2": "哭",
"reply": "别哭了[tv_微笑]摸摸您 (^・ω・^)"
}
]
}
}
```
</details>
## 修改自动回复文本/关键词回复规则
> <https://api.vc.bilibili.com/x/im/auto_reply/set_reply_text>
*请求方式：POST*
认证方式：Cookie（SESSDATA）
仅调用本接口不会开启或关闭自动回复功能，请使用 “[修改用户偏好设置](#修改用户偏好设置)” 接口
**正文参数（application/x-www-form-urlencoded）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ---------------------- | ---------------------------------------------------------------------------- |
| type | num | 自动回复类型 | 必要 | 1：被关注回复<br />2：关键词回复<br />3：收到消息回复<br />5：大航海上船回复 |
| reply | str | 回复内容 | 必要 | 最多 500 个字符 |
| id | str | 规则id | 非必要 | 当类型为 “关键词回复” 时有效<br />为 `0` 或为空时新增回复规则，否则修改 id 对应的回复规则 |
| title | str | 规则名称 | 关键词回复必要 | 当类型为 “关键词回复” 时有效，最多 30 个字符 |
| key1 | str | 精确匹配关键词 | 关键词回复必要（可选） | 当类型为 “关键词回复” 时有效，`key1` 与 `key2` 须至少填一个参数<br />以中文逗号分隔每一个关键词，最多 20 项 |
| key2 | str | 模糊匹配关键词 | 关键词回复必要（可选） | 当类型为 “关键词回复” 时有效，`key1` 与 `key2` 须至少填一个参数<br />以中文逗号分隔每一个关键词，最多 20 项 |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
| csrf_token | str | CSRF Token（位于cookie） | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />27011：请求参数错误<br />1500001：自动回复内容太长<br />1500002：规则数量已达上限，请删除后新建<br />1500003：您保存的内容含敏感信息，请修改后重试 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 空对象 |
**示例：**
修改关键词回复规则 `id=201321`，规则名称为 `谢谢`，精确匹配关键词为 `谢谢，Thank you，感谢`，回复内容为 `嗯嗯，不用谢[tv_微笑]`
```shell
curl 'https://api.vc.bilibili.com/x/im/auto_reply/set_reply_text' \
--data-urlencode 'type=2' \
--data-urlencode 'reply=嗯嗯，不用谢[tv_微笑]' \
--data-urlencode 'id=201321' \
--data-urlencode 'title=谢谢' \
--data-urlencode 'key1=谢谢，Thank you，感谢' \
--data-urlencode 'key2=' \
--data-urlencode 'build=0' \
--data-urlencode 'mobi_app=web' \
--data-urlencode 'csrf_token=xxx' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {}
}
```
</details>
## 删除关键词回复规则
> <https://api.vc.bilibili.com/x/im/auto_reply/del_reply_text>
*请求方式：POST*
认证方式：Cookie（SESSDATA）
**正文参数（application/x-www-form-urlencoded）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | ------ | ------------- |
| id | str | 规则id | 必要 | |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
| csrf_token | str | CSRF Token（位于cookie） | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-500：服务器错误<br />1003：不能删除别人的规则 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 空对象 |
**示例：**
删除关键词回复规则 `id=201321`
```shell
curl 'https://api.vc.bilibili.com/x/im/auto_reply/del_reply_text' \
--data-urlencode 'id=201321' \
--data-urlencode 'build=0' \
--data-urlencode 'mobi_app=web' \
--data-urlencode 'csrf_token=xxx' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {}
}
```
</details>
## 获取系统设置
> <https://api.vc.bilibili.com/link_setting/v1/link_setting/get_sys_setting>
*请求方式：GET*
认证方式：Cookie（SESSDATA）
此接口中的设置一般不能由用户随意更改
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------- | ------ | ------------------------- |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
| msg | str | 错误信息 | 默认为0 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data` 对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------------------------- | ---- | ---------------------------------------------------------------------------------------- | -------------------------- |
| is_create_group_available | num | 是否可创建粉丝团 | 粉丝数达到 1000 后开启 |
| is_auto_reply_available | num | 是否可使用自动回复功能 | 粉丝数达到 1000 后开启 |
| vc_hint_title | str | 稿件自动推送小灰条内容 | `我为什么会收到此类消息` |
| vc_hint_title_button | str | 稿件自动推送小灰条旁的按钮内容 | `了解更多` |
| vc_hint_detail | str | 稿件自动推送详细信息小灰条内容 | `您【特别关注】的UP主更新视频或专栏后，会第一时间在私信推送给您。如有需要可点击右上角设置关闭推送。` |
| vc_hint_detail_button | str | 关闭稿件自动推送按钮内容 | `关闭推送` |
| auto_reply_html | str | 自动回复H5页面url | `https://message.bilibili.com/h5/app/auto-reply` |
| is_receive_unfollow_wl | num | 是否显示限制接收未关注人消息功能 | |
| is_voyage | num | 是否在自动回复页面显示 “大航海自动回复” 选项 | 仅部分用户开启 |
| is_auto_reply_recommend_available | num | 是否在自动回复中的 “被关注回复” 页面显示 “被关注后，向关注我的人推送我的往期作品” 复选框 | 仅部分用户开启 |
| is_discuss_style_im_page | num | （？） | **作用尚不明确** |
| discuss_unread_style_im_page | num | （？） | **作用尚不明确** |
| old_up_assistant_door | obj | 原 “UP主小助手” 入口相关信息 | |
| is_new_up_assistant_effective | num | 新 “UP主小助手” 是否启用 | |
| is_archive_gray | bool | 是否不显示 “私信存档” 按钮 | |
| session_cfg | obj | 特定私信会话配置信息 | |
| migrate_session_api | bool | （？） | **作用尚不明确** |
| game_msg | obj | （？） | **作用尚不明确**；仅当请求参数 `mobi_app` 不为 `web` 时有其中的项目 |
| auto_reply_msg_desc | str | 指示消息为自动回复消息的提示内容 | `此条消息为自动回复` |
| huahuo_group_icon_new | str | 浅色模式下的花火图标url | |
| huahuo_group_icon_dark_new | str | 深色模式下的花火图标url | |
| im_disabled_input_hint | str | 某UP主禁用私信功能时的提示内容 | `请到UP主空间发起咨询` |
`data` 中的 `old_up_assistant_door` 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ---- | ---------------------------- | ------------ |
| show_old_up_door | num | 是否显示原 “UP主小助手” 入口 | 目前恒为 `0` |
| title | str | 原 “UP主小助手” 入口标题 | 目前为空文本 |
| sub_title | str | 原 “UP主小助手” 入口子标题 | 目前为空文本 |
`data` 中的 `session_cfg` 对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ---------------- | ---- |
| {用户mid} | obj | 该会话的配置信息 | |
`session_cfg` 中的 `{用户mid}` 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ---- | -------------------- | ------------------- |
| hidden_emote_btn | bool | 是否隐藏表情按钮 | |
| hidden_pic_btn | bool | 是否隐藏发送图片按钮 | |
| max_height | num | 最大高度（？） | **作用尚不明确** |
| hint_text | str | 私信输入框的提示内容 | `你想问什么问题呢?` |
| hidden_top_hint | bool | （？） | **作用尚不明确** |
| is_gpt_account | bool | 是否为AI会话 | |
`data` 中的 `game_msg` 对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---- | ------------------------------------------------------------- |
| show_install | bool | true | **作用尚不明确**；仅当请求参数 `mobi_app` 不为 `web` 时有此项 |
**示例：**
```shell
curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_sys_setting' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "0",
"message": "0",
"ttl": 1,
"data": {
"is_create_group_available": 1,
"is_auto_reply_available": 1,
"vc_hint_title": "我为什么会收到此类消息",
"vc_hint_title_button": "了解更多",
"vc_hint_detail": "您【特别关注】的UP主更新视频或专栏后，会第一时间在私信推送给您。如有需要可点击右上角设置关闭推送。",
"vc_hint_detail_button": "关闭推送",
"auto_reply_html": "https://message.bilibili.com/h5/app/auto-reply",
"is_receive_unfollow_wl": 0,
"is_voyage": 1,
"is_auto_reply_recommend_available": 0,
"is_discuss_style_im_page": 0,
"discuss_unread_style_im_page": 0,
"old_up_assistant_door": {
"show_old_up_door": 0,
"title": "",
"sub_title": ""
},
"is_new_up_assistant_effective": 1,
"is_archive_gray": true,
"session_cfg": {
"100000000000001": {
"hidden_emote_btn": true,
"hidden_pic_btn": true,
"max_height": 62,
"hint_text": "你想问什么问题呢?",
"hidden_top_hint": true,
"is_gpt_account": true
},
"100000000000002": {
"hidden_emote_btn": true,
"hidden_pic_btn": true,
"max_height": 62,
"hint_text": "你想问什么问题呢?",
"hidden_top_hint": true,
"is_gpt_account": true
},
"1400565964": {
"hidden_emote_btn": true,
"hidden_pic_btn": true,
"max_height": 62,
"hint_text": "你想问什么问题呢?",
"hidden_top_hint": true,
"is_gpt_account": true
}
},
"migrate_session_api": false,
"game_msg": {
"show_install": true
},
"auto_reply_msg_desc": "此条消息为自动回复",
"huahuo_group_icon_new": "http://i0.hdslb.com/bfs/kfptfe/floor/e2e3829e514ebccab1705636b0354ec89446a4b5.png",
"huahuo_group_icon_dark_new": "http://i0.hdslb.com/bfs/kfptfe/floor/d09bc8c0716a15938ec427db5fa962733703f3ce.png",
"im_disabled_input_hint": "请到UP主空间发起咨询"
}
}
```
</details>
## 获取创建粉丝团按钮可见性
> <https://api.vc.bilibili.com/link_group/v1/member/show_create_group_icon>
*请求方式：GET*
认证方式：Cookie（SESSDATA）
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------- | ------ | ------------------------- |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
| msg | str | 错误信息 | 默认为0 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data` 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---------------------- | ---------------------- |
| show | num | 是否显示创建粉丝团按钮 | 粉丝数达到 1000 后显示 |
**示例：**
```shell
curl 'https://api.vc.bilibili.com/link_group/v1/member/show_create_group_icon' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"msg": "0",
"message": "0",
"ttl": 1,
"data": {
"show": 1
}
}
```
</details>

2
docs/user/info.md
View File

@ -318,7 +318,7 @@
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ---------------- | ---------------- |
| show | bool | 是否显示充电按钮 | |
| state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通高档、自定义充电 |
| state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通包月高档、自定义充电 |
| title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` |
| icon | str | 充电图标 | |
| jump_url | str | 跳转url | |

596
docs/user/relation.md
View File

File diff suppressed because it is too large Load Diff

4
docs/video/info.md
View File

@ -67,7 +67,7 @@
| is_chargeable_season | bool | | |
| is_story | bool | 是否可以在 Story Mode 展示? | |
| is_upower_exclusive | bool | 是否为充电专属视频 | |
| is_upower_pay | bool | | |
| is_upower_play | bool | | |
| is_upower_preview | bool | 充电专属视频是否支持试看 | |
| no_cache | bool | 是否不允许缓存? | |
| pages | array | 视频分P列表 | |
@ -676,7 +676,7 @@ https://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg
`data`中的`Tags`数组：
基本同「[获取视频TAG信息](tags.md#获取视频TAG信息)」中的data数组
基本同「[获取视频TAG信息（新）](tags.md#获取视频TAG信息新)」中的data数组
`data`中的`Reply`对象：

24
docs/video/player.md
View File

@ -60,7 +60,7 @@ web 播放器的信息接口，提供正常播放需要的元数据，包括：
| now_time | num | 当前 UNIX 秒级时间戳 | |
| online_count | num | 在线人数 | |
| need_login_subtitle | bool | 是否必须登陆才能查看字幕 | 是的 |
| preview_toast | str | `为创作付费，购买观看完整视频|购买观看` | |
| preview_toast | str | `为创作付费，购买观看完整视频\|购买观看` | |
| options | obj | | |
| guide_attention | any | | |
| jump_card | any | | |
@ -70,10 +70,10 @@ web 播放器的信息接口，提供正常播放需要的元数据，包括：
| show_switch | obj | | |
| bgm_info | obj | 背景音乐信息 | |
| toast_block | bool | | |
| is_upower_exclusive | bool | 充电专属? | |
| is_upower_exclusive | bool | 是否为充电专属视频 | |
| is_upower_play | bool | | |
| is_ugc_pay_preview | bool | | |
| elec_high_level | obj | | |
| elec_high_level | obj | 充电专属视频信息 | |
| disable_show_up_info | bool | | |
`data` 对象中的 `options` 对象:
@ -126,7 +126,7 @@ web 播放器的信息接口，提供正常播放需要的元数据，包括：
|subtitle_url|str| 资源 url 地址 | |
|type| num | 0 | |
`view_point` 数组内的元素:
`data`对象中的`view_point` 数组内的元素:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | -------- | ---- |
@ -139,6 +139,22 @@ web 播放器的信息接口，提供正常播放需要的元数据，包括：
| team_type | str | | |
| team_name | str | | |
`data`对象中的`elec_high_level`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ------------------------------ | ---------------- |
| privilege_type | num | 解锁视频所需最低定价档位的代码 | 见[充电档位代码与定价](../electric/monthly.md#充电档位代码privilege_type与定价) |
| title | str | 提示标题 | `该视频为「{充电档位名称}」专属视频` |
| sub_title | str | 提示子标题 | `开通「{充电档位定价}元档包月充电」即可观看` |
| show_button | bool | 是否显示按钮 | |
| button_text | str | 按钮文本 | `去开通` |
| jump_url | obj | 跳转url信息 | 详细信息有待补充 |
| intro | str | 充电介绍语 | |
| open | bool | （？） | |
| new | bool | （？） | |
| question_text | str | （？） | |
| qa_detail_link | str | （？） | |
**示例:**
未登录, `aid=1906473802`

138
docs/video/tags.md
View File

@ -1,8 +1,132 @@
# 视频TAG
## 获取视频TAG信息
## 获取视频TAG信息（新）
> https://api.bilibili.com/x/tag/archive/tags
> <https://api.bilibili.com/x/web-interface/view/detail/tag>
*请求方式：GET*
认证方式：Cookie（SESSDATA）
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------------ | -------------------------------- |
| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
| cid | num | 分P cid | 非必要 | 提供此参数可返回对应分P的BGM信息 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | array | TAG列表 | 无TAG为空 |
`data`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | ---- |
| 0 | obj | 第1个TAG | |
| n | obj | 第（n+1）个TAG | |
| …… | obj | …… | …… |
`data`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ---------- | ------------------------------------------------------------ |
| tag_id | num | tag_id | 当`tag_type`不为`bgm`时有效 |
| tag_name | str | TAG名称 | |
| music_id | str | 背景音乐id | 当`tag_type`为`bgm`时有效，以`MA`开头 |
| tag_type | str | TAG类型 | `old_channel`：普通标签<br />`topic`：话题<br />`bgm`：背景音乐 |
| jump_url | str | 跳转url | 当`tag_type`为`topic`或`bgm`时有效 |
**示例：**
查询视频`av89772773`/`BV1M741177Kg`的TAG
avid方式：
```shell
curl -G 'https://api.bilibili.com/x/web-interface/view/detail/tag' \
--data-urlencode 'aid=89772773' \
--data-urlencode 'cid=153322313' \
-b 'SESSDATA=xxx'
```
bvid方式：
```shell
curl -G 'https://api.bilibili.com/x/web-interface/view/detail/tag' \
--data-urlencode 'bvid=BV1M741177Kg' \
--data-urlencode 'cid=153322313' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": [
{
"tag_id": 0,
"tag_name": "发现《Other Side》",
"music_id": "MA456128506519140428",
"tag_type": "bgm",
"jump_url": "https://music.bilibili.com/h5/music-detail?music_id=MA456128506519140428&cid=153322313&aid=89772773&na_close_hide=1"
},
{
"tag_id": 12620189,
"tag_name": "异度侵入",
"music_id": "",
"tag_type": "old_channel",
"jump_url": ""
},
{
"tag_id": 707,
"tag_name": "ED",
"music_id": "",
"tag_type": "old_channel",
"jump_url": ""
},
{
"tag_id": 1394,
"tag_name": "动漫",
"music_id": "",
"tag_type": "old_channel",
"jump_url": ""
},
{
"tag_id": 13289329,
"tag_name": "异度侵入ed原图",
"music_id": "",
"tag_type": "old_channel",
"jump_url": ""
},
{
"tag_id": 7520816,
"tag_name": "bilibili新星计划",
"music_id": "",
"tag_type": "old_channel",
"jump_url": ""
}
]
}
```
</details>
## 获取视频TAG信息（旧）
> <https://api.bilibili.com/x/tag/archive/tags>
*请求方式：GET*
@ -20,7 +144,7 @@
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ---------------------------- |
| ------- | ----- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
@ -46,7 +170,7 @@
| short_content | str | TAG简介 | |
| type | num | ？？？ | |
| state | num | 0 | |
| ctime | num | 创建时间 | 时间戳 |
| ctime | num | 创建时间 | 秒级时间戳 |
| count | obj | 状态数 | |
| is_atten | num | 是否关注 | 0：未关注<br />1：已关注<br />需要登录(Cookie) <br />未登录为0 |
| likes | num | 0 | 作用尚不明确 |
@ -205,7 +329,7 @@ curl -G 'https://api.bilibili.com/x/tag/archive/tags' \
## 点赞&取消点赞视频TAG
> https://api.bilibili.com/x/tag/archive/like2
> <https://api.bilibili.com/x/tag/archive/like2>
*请求方式：POST*
@ -258,13 +382,13 @@ curl 'https://api.bilibili.com/x/tag/archive/like2' \
## 点踩&取消点踩视频TAG
> https://api.bilibili.com/x/tag/archive/hate2
> <https://api.bilibili.com/x/tag/archive/hate2>
*请求方式：POST*
认证方式：Cookie（SESSDATA）
重复访问为取消
重复请求为取消
**正文参数（ application/x-www-form-urlencoded ）：**

1
docs/video/videostream_url.md
View File

@ -18,6 +18,7 @@
| 64 | 720P 高清 | WEB 端默认值<br />~~B站前端需要登录才能选择，但是直接发送请求可以不登录就拿到 720P 的取流地址~~<br />**无 720P 时则为 720P60** |
| 74 | 720P60 高帧率 | 登录认证 |
| 80 | 1080P 高清 | TV 端与 APP 端默认值<br />登录认证 |
| 100 | 智能修复 | 人工智能增强画质<br />大会员认证
| 112 | 1080P+ 高码率 | 大会员认证 |
| 116 | 1080P60 高帧率 | 大会员认证 |
| 120 | 4K 超清 | 需要`fnval&128=128`且`fourk=1`<br />大会员认证 |

4
docs/vip/info.md
View File

@ -43,7 +43,7 @@
| bind_phone | str | 绑定的手机号 | 星号隐藏部分信息 |
| taobao_account | 有效时：obj<br />无效时：null | 绑定的淘宝账号 | |
`list`数组中的对象：
`list`数组：
| 索引 | 类型 | 内容 | type | 备注 |
| ---- | ---- | -------------------------------- | ---- | ------------------------------- |
@ -57,7 +57,7 @@
| 7 | obj | （~~王者荣耀~~）游戏礼盒兑换状态 | 8 | 每日可领取，目前 state 固定为 1 |
| 8 | obj | 每日 10 经验领取状态 | 9 | 每日可领取，未完成时 state 为 2 |
`list`中的对象：
`list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | -------------------- | ----------------------------------------------------- |