From 17b0e43ec2573a3b7f99d5c4c204a4f3b7f9641b Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sat, 19 Apr 2025 01:17:32 +0800 Subject: [PATCH 01/12] feat: add details --- docs/misc/sign/v_voucher.md | 4 +++- docs/misc/sign/wbi.md | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/misc/sign/v_voucher.md b/docs/misc/sign/v_voucher.md index ccc25e9..3804c80 100644 --- a/docs/misc/sign/v_voucher.md +++ b/docs/misc/sign/v_voucher.md @@ -6,12 +6,14 @@ `v_voucher` 结构为字符串 `voucher_` 尾随一串以 `-` 为分隔符的小写 UUID -`v_voucher` 可用于申请 captcha 验证码, 根据验证结果使用 `validate` 接口获取 `grisk_id` 作为被风控接口的 `gaia_vtoken` 与 Cookie 中的 `x-bili-gaia-vtoken` 即可恢复正常访问 +`v_voucher` 可用于申请 captcha 验证码, 若无意外发生, 根据验证结果使用 `validate` 接口获取 `grisk_id` 作为被风控接口的 `gaia_vtoken` 与 Cookie 中的 `x-bili-gaia-vtoken`, 即可恢复正常访问 若该情况出现在使用 Wbi 签名的接口中, 建议先检查 Wbi 签名是否正确. 若已检查 Wbi 签名或无需签名, 检查请求头中 `User-Agent` `Referer` 是否正常, 以及 `Cookie` 中 [`bili_ticket`](bili_ticket.md) [`b_nut` `buvid3` `buvid4`](../buvid3_4.md) 等是否存在. 使用 captcha 是最后的选择, 因为 captcha 验证需要用户操作 参见 [#1067](https://github.com/SocialSisterYi/bilibili-API-collect/issues/1067) +**注意: 不是所有风控都可以使用本方式通过 captcha 解决** + ## 操作流程 1. 快速以不正确的姿势请求接口, 直到返回 `v_voucher` 字段如下. 若 `data` 中没有 `v_voucher` 字段, 则检查响应头 `x-bili-gaia-vvoucher` diff --git a/docs/misc/sign/wbi.md b/docs/misc/sign/wbi.md index 23eae00..6083d51 100644 --- a/docs/misc/sign/wbi.md +++ b/docs/misc/sign/wbi.md @@ -2,7 +2,7 @@ 自 2023 年 3 月起，Bilibili Web 端部分接口开始采用 WBI 签名鉴权，表现在 REST API 请求时在 Query param 中添加了 `w_rid` 和 `wts` 字段。WBI 签名鉴权独立于 [APP 鉴权](APP.md) 与其他 Cookie 鉴权，目前被认为是一种 Web 端风控手段。 -经持续观察，大部分查询性接口都已经或准备采用 WBI 签名鉴权，请求 WBI 签名鉴权接口时，若签名参数 `w_rid` 与时间戳 `wts` 缺失、错误，会返回 `v_voucher`，如： +经持续观察，大部分查询性接口都已经或准备采用 WBI 签名鉴权，请求 WBI 签名鉴权接口时，若签名参数 `w_rid` 与时间戳 `wts` 缺失、错误，会返回 [`v_voucher`](v_voucher.md)，如： ```json {"code":0,"message":"0","ttl":1,"data":{"v_voucher":"voucher_******"}} From 65c88d57205c3da55e2d9f36386bd4e8544b4f77 Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sat, 19 Apr 2025 02:57:09 +0800 Subject: [PATCH 02/12] feat(CONTRIBUTING.md): Commit and PR --- CONTRIBUTING.md | 50 ++++++++++++++++++++++++++++++++++--------------- 1 file changed, 35 insertions(+), 15 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6c283a6..7025530 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -6,7 +6,7 @@ [bilibili-API-collect](https://github.com/SocialSisterYi/bilibili-API-collect) 项目（简称 BAC 或 b-a-c）是一个仅用于学习研究、社区开源、公益性质的 [B 站（哔哩哔哩）](https://www.bilibili.com/)API（应用程序接口）文档，使用 [CC-BY-NC 4.0 协议](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/LICENSE)开源，它将无差别收集整理相关的**主站业务接口**。 -该项目使用 [MarkDown](https://zh.wikipedia.org/zh-cn/Markdown) 语法进行文档书写，按照业务类型及功能以**路径**＋**文件**形式索引，任何用户都可通过 Issue、Pull Request 与 Discussion 提供自己分析出的接口地址与使用说明。 +该项目使用 [Markdown](https://zh.wikipedia.org/zh-cn/Markdown) 语法进行文档书写，按照业务类型及功能以**路径**＋**文件**形式索引，任何用户都可通过 Issue、Pull Request 与 Discussion 提供自己分析出的接口地址与使用说明。 本项目收集的接口类型包括但不限于 REST API、gRPC、WebSocket，文档内统一优先使用安全套接字协议，如 `https`、`securityRpc`、`wss`。 @@ -16,9 +16,9 @@ 提交 Issue 请遵守以下原则： -1. 标题需要点明 API 的用处，如 `[新增请求] 新增 xx 接口`、`[更新请求] xx 接口地址已失效`、`[更新请求] xx 接口的参数有变化`，切勿仅填写 `补充`、`修复` 等标题 +1. 标题需要点明 API 的用处, `` 要替换为标题主要内容而不是保留不动，切勿仅填写 `补充`、`修复`，形式良好的标题可以是 `[新增请求] 新增 xx 接口`、`[更新请求] xx 接口地址已失效`、`[更新请求] xx 接口的参数有变化` 2. 正文请按照 Issue 模板进行填写，标明 API 来源（Web、Android、iOS、TV 等）、API 类型（REST、gRPC、WebSocket 等）、API 地址 -3. 详情描述需要提供该 API 的使用场景、请求及响应字段等，可附上原始抓包记录；在更新时还需指出原文档中与最新 API 行为不符之处，并附上已知的最新改动。例如：“在前端页面某地址 / APP 某界面访问某 API（标明地址），它的某参数与文档中不符（标明文档地址）” +3. 详情描述需要提供该 API 的使用场景、请求及响应字段等，可附上原始抓包记录 (文本格式优先)；在更新时还需指出原文档中与最新 API 行为不符之处，并附上已知的最新改动。例如：“在前端页面某地址 / APP 某界面访问某 API（标明地址），它的某参数与文档中不符（标明文档地址）” 发起 Discussion 请遵守以下原则： @@ -69,27 +69,27 @@ Telegram 交流群主要用作 [BAC 项目](https://github.com/SocialSisterYi/bi ### 路径 -路径层级应当与文档目录一致，以文件夹的形式存放在项目中的 `/docs` 路径下，命名统一使用英文小写，如 `video`、`danmaku`、`comment` +路径层级应当与文档目录一致，以文件夹的形式存放在项目中的 `/docs` 路径下，命名统一使用英文小写，如 `video`、`danmaku`、`comment`, 不建议出现 `&` 等特殊字符 二级、三级路径应当存在二级三级目录，可选添加 `README.md` 以描述该子目录 ### 文件 -各个子接口集整理为 MarkDown（md）文件，命名统一使用英文小写，如 `info.md`、`action.md`、`list.md` +各个子接口集整理为 Markdown (.md) 文件，命名统一使用英文小写，如 `info.md`、`action.md`、`list.md` 文档文件中用于存放相关的接口的说明，如 `video/` 下的 `info.md`，存在 `查询视频基本信息`、`查询视频简介`、`查询视频分P列表` 等内容 ## Markdown 文档内容格式 -文档使用 [Vuepress](https://vuepress.vuejs.org/) 生成，可以使用 [Vuepress md 扩展语法](https://vuepress.vuejs.org/guide/markdown.html)编写 +文档使用 [VuePress](https://vuepress.vuejs.org/) 生成，可以使用 [VuePress Markdown 扩展语法](https://vuepress.vuejs.org/guide/markdown.html)编写 -注：以下文档范式可根据**实际情况**进行调整 +注：以下文档范式可根据**实际情况**进行调整, 你也可以使用 `json-apidoc-gen` 工具直接生成模板自行填充内容 ### 头部 文档首行为**一级标签**格式标题，如 `# 用户基本信息` -**文档头部不再需要手写索引**，索引由 Vuepress 自动生成 +**文档头部不需要手写索引**，索引由 VuePress 自动生成 ### 接口说明 @@ -121,7 +121,7 @@ e.g.： **请求参数**应在**接口说明**的下方，应注明参数类型 url 参数或正文参数（正文参数应注明 content-type，如 `application/x-www-form-urlencoded` 或 `multipart/form-data`），使用**加粗**语法 -对象的字段及其含义使用**表格**进行整理，表头统一依次为 `参数名`、`类型`、`内容`、`必要性`、`备注`，类型为 `num`、`str`、`bool`、`nums`、`strs`、`file` 等，必要性为 `必要`、`非必要`、`必要 (可选)` 等，表格内每个字段为一行 +对象的字段及其含义使用**表格**进行整理，表头统一依次为 `参数名`、`类型`、`内容`、`必要性`、`备注`，类型为 `num`、`str`、`bool`、`nums`、`strs`、`file` 等 (未来可能会统一改为基于 TypeScript 的类型系统)，必要性为 `必要`、`非必要`、`必要 (可选)` 等，表格内每个字段为一行 e.g.： @@ -132,13 +132,13 @@ e.g.： **响应正文**应在**请求参数**的下方，接口响应的数据格式应标注，如 `JSON 回复`、`XML 回复`、`ProtoBuf 回复`，使用**加粗**语法 -JSON Object 或 ProtoBuf Message 应以对象的**表格**形式书写，表头为 `根对象` 或 `xx 中的 yy 对象`，若对象位于数组中则为 `xx 数组中的对象` +JSON Object 或 ProtoBuf Message 应以对象的**表格**形式书写，表头为 `根对象` 或 `xx 中的 yy 对象` 或 `xx.yy.zz 对象`，若对象位于数组中则为 `xx 数组中的对象` 或 `xx[] 中的对象` 表头统一依次为 `字段`、`类型`、`内容`、`备注`，类型为 JSON / Protobuf 的标准类型，如 `num`、`str`、`bool`、`obj`、`array`、`null` 等 不明确定义的字段说明在内容的末尾添加问号，如 `播放数？`；定义尚未明确的字段使用 `（？）` 在内容中占位，并在备注中填写 `作用尚不明确` -多个对象及数组，使用**遍历树**的顺序进行排列 +多个对象及数组，使用**遍历树**的顺序进行排列, 若数组中的每一项结构均相同也可以直接省略为像 `xxx 数组中的对象` 这样的格式 e.g.： @@ -168,13 +168,13 @@ e.g.： **示例**部分位于所有**响应正文**部分下方，需要**加粗**格式，分为请求命令示例与响应体示例两部分 -请求命令示例为一段可测试该接口的 curl 命令或 Python 脚本，使用**代码块**语法书写，命令应当尽可能简短、便于使人阅读 +请求命令示例为一段可测试该接口的 cURL 命令或某种编程语言的代码，使用**代码块**语法书写，命令应当尽可能简短、便于使人阅读, 代码缩进为 **2** 个 **空格 (U+0020)** 示例命令中的认证信息应做**脱敏处理**，如 Cookie、Token、access_key 等，可替换为 `xxx` 占位 示例命令前后可以适当添加一些文字说明 -响应体示例为一段格式化后的 JSON 或 ProtoBuf Message，使用**代码块**语法书写，并使用 `<details>` 标签进行折叠 +响应体示例为一段格式化后的 JSON 或 ProtoBuf Message，使用**代码块**语法书写，并使用 `<details>` 标签进行折叠, 仍一律使用 **2** 个 **空格** 进行缩进 e.g.： @@ -258,6 +258,26 @@ message Author { ## 文档提交 -使用 Pull Request 将修改后的文档提交到 `master` 分支，标题需写明提交的内容 +### 拉取 (Pull) 与 提交 (Commit) -（TODO） +本项目仓库仅托管于 GitHub, 使用 Git 作为版本控制系统, 你需要对两者有基础的了解 + +请先 fork, 然后在自己的 fork 上进行修改 + +提交的标题不要使用默认的 `Update xxx`, 建议遵循 [Conventional Commits (约定式提交) 规范](https://www.conventionalcommits.org/zh-hans/v1.0.0/), 标题语言可根据个人习惯 + +当发现远程与本地仓库不一致时, 若你操作的 fork 的 branch 无打开的 PR, 建议使用变基拉取, 而不是生成一个额外的合并提交的合并拉取, 反之则相反 + +移动文件请使用 `git mv`, 而不是删除并添加同一个文件于不同位置 (该问题在 VSCode 的 GUI 版 Git 中存在) + +### 拉取请求 (Pull Request) + +使用 拉取请求 (Pull Request, PR) 将修改后的文档提交到 `master` 分支，标题需写明修改或新增的内容, `gh_pages` 分支将在 PR 合并后自动更新 + +如果你还没有完成计划的全部修改, 请创建 Draft Pull Request 表示你还没有做好被合并的准备<!--(精神可嘉值得鼓励)--> + +PR 正文使用 **无序列表** 写明更改的每一项内容, 可以使用复选框表明进度, 需要关闭的 Issue 请使用 `close #xxxx` 这样的格式一并包含在内 + +如果内容包含代码, 请一并提供测试的输入与输出的文本或截图, 最好可以附上完整的测试环境或相关可执行文件 + +PR 合并后, 请及时删除或更新分支. 特别是在使用压缩合并或变基合并后, 请 `Discard changes` 或直接删除分支, 以免在下一次 PR 后出现重复相同提交的问题 From 22c19c917ea5eb11aa2835780ffac101a90fbfaf Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sat, 19 Apr 2025 03:24:17 +0800 Subject: [PATCH 03/12] feat(misc/sign/wbi.md): add details --- docs/misc/sign/wbi.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/docs/misc/sign/wbi.md b/docs/misc/sign/wbi.md index 6083d51..2eb4777 100644 --- a/docs/misc/sign/wbi.md +++ b/docs/misc/sign/wbi.md @@ -12,6 +12,8 @@ 细节更新：[#885](https://github.com/SocialSisterYi/bilibili-API-collect/issues/885)。 +最新进展: [#919](https://github.com/SocialSisterYi/bilibili-API-collect/issues/919) + ## WBI 签名算法 1. 获取实时口令 `img_key`、`sub_key` @@ -30,6 +32,7 @@ `img_key`、`sub_key` 全站统一使用，观测知应为**每日更替**，使用时建议做好**缓存和刷新**处理。 特别地，发现部分接口将 `img_key`、`sub_key` 硬编码进 JavaScript 文件内，如搜索接口 `https://s1.hdslb.com/bfs/static/laputa-search/client/assets/index.1ea39bea.js`，暂不清楚原因及影响。 + 同时, 部分页面会在 SSR 的 `__INITIAL_STATE__` 包含 `wbiImgKey` 与 `wbiSubKey`, 具体可用性与区别尚不明确 2. 打乱重排实时口令获得 `mixin_key` @@ -78,9 +81,9 @@ ```javascript { - foo: '114', - bar: '514', - zab: 1919810 + foo: '114', + bar: '514', + zab: 1919810 } ``` @@ -97,17 +100,17 @@ } ``` - 随后按键名升序排序后编码 URL Query，拼接前面得到的 `mixin_key`，如 `bar=514&foo=114&wts=1702204169&zab=1919810ea1db124af3c7062474693fa704f4ff8`，计算其 MD5 即为 `w_rid`。 + 随后按键名升序排序后百分号编码 URL Query，拼接前面得到的 `mixin_key`，如 `bar=514&foo=114&wts=1702204169&zab=1919810ea1db124af3c7062474693fa704f4ff8`，计算其 MD5 即为 `w_rid`。 - 需要注意的是：如果参数值含中文或特殊字符等，编码字符字母应当**大写** （部分库会编码为小写字母），空格应当编码为 `%20`（部分库按 `application/x-www-form-urlencoded` 约定编码为 `+`）。 + 需要注意的是：如果参数值含中文或特殊字符等，编码字符字母应当**大写** （部分库会错误编码为小写字母），空格应当编码为 `%20`（部分库按 `application/x-www-form-urlencoded` 约定编码为 `+`）, 具体正确行为可参考 [encodeURIComponent 函数](https://tc39.es/ecma262/multipage/global-object.html#sec-encodeuricomponent-uricomponent) 例如： ```javascript { - foo: 'one one four', - bar: '五一四', - baz: 1919810 + foo: 'one one four', + bar: '五一四', + baz: 1919810 } ``` @@ -121,7 +124,7 @@ ## Demo -含 [Python](#python)、[JavaScript](#javascript)、[Golang](#golang)、[C#](#csharp)、[Java](#java)、[Kotlin](#kotlin)、[Swift](#swift)、[C++](#cplusplus)、[Rust](#rust)、[Haskell](#haskell) 语言编写的 Demo 。 +含 [Python](#python)、[JavaScript](#javascript)、[Golang](#golang)、[C#](#csharp)、[Java](#java)、[Kotlin](#kotlin)、[Swift](#swift)、[C++](#cplusplus)、[Rust](#rust)、[Haskell](#haskell) 语言编写的 Demo ### Python From 0a6eb83152c01e162a3fd2a39d38b6424527f423 Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sat, 19 Apr 2025 16:44:15 +0800 Subject: [PATCH 04/12] fix: broken funding links & wrong link desc --- .github/FUNDING.yml | 2 +- README.md | 5 ++--- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml index 8d6d4b5..b5cfe71 100644 --- a/.github/FUNDING.yml +++ b/.github/FUNDING.yml @@ -9,4 +9,4 @@ community_bridge: # Replace with a single Community Bridge project-name e.g., cl liberapay: # Replace with a single Liberapay username issuehunt: # Replace with a single IssueHunt username otechie: # Replace with a single Otechie username -custom: https://afdian.net/@ShakaiAneE +custom: https://afdian.com/@ShakaiAneE diff --git a/README.md b/README.md index 519ffa2..0f321d3 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接 1. 文档二级目录尚未完成 2. 部分文档较旧，修改与更新没有跟进 -3. 目前文档使用 markdown 语法编写，不易生成编程语言的 SDK，详见 [#604](https://github.com/SocialSisterYi/bilibili-API-collect/issues/604) +3. 目前文档使用 Markdown 语法编写，不易生成编程语言的 SDK，详见 [#604](https://github.com/SocialSisterYi/bilibili-API-collect/issues/604) 更多信息请浏览 [贡献指南](CONTRIBUTING.md) @@ -126,7 +126,6 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接 - [x] [视频在线人数](docs/video/online.md) - [x] [视频 AI 摘要](docs/video/summary.md) - [ ] [稿件投诉](docs/video/appeal.md) - - [ ] [视频状态数](docs/video/status_number.md) - [ ] [视频合集](docs/video/collection.md) - [ ] [播放器](docs/video/player.md) - [ ] [剧集 (番剧、影视)](docs/bangumi) @@ -333,7 +332,7 @@ WeChat & Alipay： <img src="./assets/img/sponsorQR.jpg" width="300" height="300" /> -OR Aifadian：[https://afdian.net/@ShakaiAneE](https://afdian.net/@ShakaiAneE) +OR Aifadian：[https://afdian.com/@ShakaiAneE](https://afdian.com/@ShakaiAneE) ## 🔗相关项目推荐 From 0c42c00036ec457a4786431ba9944daf72c96fc0 Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sat, 19 Apr 2025 16:44:28 +0800 Subject: [PATCH 05/12] fix(misc/sign/APP.md): broken demo links --- docs/misc/sign/APP.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/misc/sign/APP.md b/docs/misc/sign/APP.md index b1dc9e8..8b51c05 100644 --- a/docs/misc/sign/APP.md +++ b/docs/misc/sign/APP.md @@ -23,7 +23,7 @@ ## Demo -该 Demo 提供 [Python](#Python)、[Java](#Java)、[TS/JS](#TypeScript/JavaScript)、[Swift](#Swift)、[C++](#CplusPlus) 语言例程 +该 Demo 提供 [Python](#python)、[Java](#java)、[TS/JS](#typescript-javascript)、[Swift](#swift)、[C++](#cplusplus) 语言例程 使用 appkey = `1d8b6e7d45233436`, appsec = `560c52ccd288fed045859ed18bffd973` 对如下 `params` 参数进行签名 From ac01f83cfff6509b166e4d63d6a5d8e1247f84e1 Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sat, 19 Apr 2025 19:09:40 +0800 Subject: [PATCH 06/12] feat(CONTRIBUTING.md): add non-api doc info --- CONTRIBUTING.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 7025530..1f47a73 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -83,7 +83,7 @@ Telegram 交流群主要用作 [BAC 项目](https://github.com/SocialSisterYi/bi 文档使用 [VuePress](https://vuepress.vuejs.org/) 生成，可以使用 [VuePress Markdown 扩展语法](https://vuepress.vuejs.org/guide/markdown.html)编写 -注：以下文档范式可根据**实际情况**进行调整, 你也可以使用 `json-apidoc-gen` 工具直接生成模板自行填充内容 +注：以下文档范式主要针对接口类文档, 可根据**实际情况**进行调整, 你也可以使用 `json-apidoc-gen` 工具直接生成模板自行填充内容. 非接口类文档, 如算法等, 可以参考已有的内容 ### 头部 @@ -274,10 +274,10 @@ message Author { 使用 拉取请求 (Pull Request, PR) 将修改后的文档提交到 `master` 分支，标题需写明修改或新增的内容, `gh_pages` 分支将在 PR 合并后自动更新 -如果你还没有完成计划的全部修改, 请创建 Draft Pull Request 表示你还没有做好被合并的准备<!--(精神可嘉值得鼓励)--> +如果你还没有完成计划的全部修改, 请创建 Draft Pull Request 表示你还没有做好被合并的准备 ~~(抢占先机, 精神可嘉, 值得鼓励)~~ PR 正文使用 **无序列表** 写明更改的每一项内容, 可以使用复选框表明进度, 需要关闭的 Issue 请使用 `close #xxxx` 这样的格式一并包含在内 -如果内容包含代码, 请一并提供测试的输入与输出的文本或截图, 最好可以附上完整的测试环境或相关可执行文件 +如果内容包含代码, 请一并提供测试的输入与输出的文本或截图, 最好可以附上完整的测试环境及相关可执行文件等 PR 合并后, 请及时删除或更新分支. 特别是在使用压缩合并或变基合并后, 请 `Discard changes` 或直接删除分支, 以免在下一次 PR 后出现重复相同提交的问题 From 031e28eb62cba0d3e91508ac2669eaafb0715db6 Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sun, 20 Apr 2025 00:38:19 +0800 Subject: [PATCH 07/12] fix: img 403 by referrer --- docs/APP_widget/splash.md | 4 ++-- docs/misc/picture.md | 11 +++++------ docs/video/info.md | 2 +- docs/video/snapshot.md | 2 +- 4 files changed, 9 insertions(+), 10 deletions(-) diff --git a/docs/APP_widget/splash.md b/docs/APP_widget/splash.md index d10d00e..2a3179c 100644 --- a/docs/APP_widget/splash.md +++ b/docs/APP_widget/splash.md @@ -134,7 +134,7 @@ curl -G 'https://app.bilibili.com/x/v2/splash/brand/list' \ 如id=11的图片为： -![]( https://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png ) +<img src="https://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png" referrerpolicy="no-referrer" /> ## 获取APP端开屏幕广告信息 @@ -564,4 +564,4 @@ curl -X GET 'https://app.bilibili.com/x/v2/splash/list' \ } } ``` -</details> \ No newline at end of file +</details> diff --git a/docs/misc/picture.md b/docs/misc/picture.md index 52df611..e16cfa0 100644 --- a/docs/misc/picture.md +++ b/docs/misc/picture.md @@ -34,32 +34,31 @@ https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg -![](https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg) +<img src="https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg" referrerpolicy="no-referrer" /> 高度限制为100 https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@100h -![](https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@100h) +<img src="https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@100h" referrerpolicy="no-referrer" /> 宽度限制为100 https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@100w -![](https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@100w) +<img src="https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@100w" referrerpolicy="no-referrer" /> 转换格式为webp https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@.webp -![](https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@.webp) +<img src="https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@.webp" referrerpolicy="no-referrer" /> 转换为webp图片质量为1% https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@1q.webp -![](https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@1q.webp) - +<img src="https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@1q.webp" referrerpolicy="no-referrer" /> </details> ## avg_color格式说明 diff --git a/docs/video/info.md b/docs/video/info.md index 25da11a..7c373ac 100644 --- a/docs/video/info.md +++ b/docs/video/info.md @@ -572,7 +572,7 @@ curl -G 'https://api.bilibili.com/x/web-interface/view' \ https://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg -![](https://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg) +<img src="https://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg" referrerpolicy="no-referrer" /> ## 获取视频超详细信息(web端) diff --git a/docs/video/snapshot.md b/docs/video/snapshot.md index 4fbd224..3bc1bb0 100644 --- a/docs/video/snapshot.md +++ b/docs/video/snapshot.md @@ -280,7 +280,7 @@ curl -G 'https://api.bilibili.com/pvideo' \ 示例拼版图片url：http://i0.hdslb.com/bfs/videoshot/49075258.jpg -![](https://i0.hdslb.com/bfs/videoshot/49075258.jpg) +<img src="https://i0.hdslb.com/bfs/videoshot/49075258.jpg" referrerpolicy="no-referrer" /> ## bin格式截取时间表 From ea76fb00e62ee9a486ee010e67d73a133ba9b7af Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sun, 20 Apr 2025 01:03:10 +0800 Subject: [PATCH 08/12] fix(misc/bvid_desc.md): cpp highlight & remove old links --- docs/misc/bvid_desc.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/misc/bvid_desc.md b/docs/misc/bvid_desc.md index 2ed0fc8..d9e3346 100644 --- a/docs/misc/bvid_desc.md +++ b/docs/misc/bvid_desc.md @@ -384,7 +384,7 @@ func main() { ### C++ -```c++ +```cpp #include <algorithm> #include <cassert> #include <print> @@ -497,9 +497,7 @@ int main() { ### 编程实现 -使用 [Python](#Python) [C](#C) [TypeScript](#TypeScript) [Java](#Java) [Kotlin](#Kotlin) [Golang](#Golang) [Rust](#Rust) 等语言作为示例，欢迎社区提交更多例程 - -注: 新算法只提供了 [Python](#Python) 和 [Rust](#Rust) 版本 +使用 Python C TypeScript Java Kotlin Golang Rust 等语言作为示例，欢迎社区提交更多例程 #### Python From 2484330f5c16a5d0ef3ade076bfed82ad997e4bd Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sun, 20 Apr 2025 17:44:05 +0800 Subject: [PATCH 09/12] =?UTF-8?q?feat(README.md):=20=E4=B8=BA=E5=A4=B1?= =?UTF-8?q?=E6=95=88=E4=B8=8E=E4=B8=8B=E7=BA=BF=E7=9A=84=E6=8E=A5=E5=8F=A3?= =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E5=88=A0=E9=99=A4=E7=BA=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 0f321d3..00da6b4 100644 --- a/README.md +++ b/README.md @@ -100,7 +100,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接 - [x] [状态数](docs/user/status_number.md) - [x] [关系](docs/user/relation.md) - [ ] [个人空间](docs/user/space.md) - - [x] [检查昵称是否可注册](docs/user/check_nickname.md) + - [x] ~~[检查昵称是否可注册](docs/user/check_nickname.md)~~ (已失效) - [x] [用户注册](docs/user/register.md) - [x] [用户认证类型一览](docs/user/official_role.md) - [ ] [加入老粉计划](docs/user/contract.md) @@ -113,7 +113,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接 - [ ] [视频](docs/video) - [x] [视频分区一览 (分区代码)](docs/video/video_zone.md) - [x] [基本信息](docs/video/info.md) - - [x] [状态数](docs/video/status_number.md) (已失效) + - [x] ~~[状态数](docs/video/status_number.md)~~ (已失效) - [x] [快照](docs/video/snapshot.md) - [x] [点赞 & 投币 & 收藏 & 分享](docs/video/action.md) - [ ] [TAG](docs/video/tags.md) @@ -220,13 +220,13 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接 - [x] [特定话题动态列表](docs/dynamic/tag_dynamics.md) - [ ] [动态内容](docs/dynamic/get_dynamic_detail.md) - [ ] [导航栏动态](docs/dynamic/nav.md) -- [ ] [相簿](docs/album) (已下线) - - [x] [基本信息](docs/album/info.md) - - [x] [相簿列表](docs/album/list.md) - - [x] [推荐作者](docs/album/recommend_author.md) - - [x] [活动列表](docs/album/activity_list.md) - - [x] [操作](docs/album/action.md) - - [ ] 投稿 +- [ ] ~~[相簿](docs/album)~~ (已下线) + - [x] ~~[基本信息](docs/album/info.md)~~ + - [x] ~~[相簿列表](docs/album/list.md)~~ + - [x] ~~[推荐作者](docs/album/recommend_author.md)~~ + - [x] ~~[活动列表](docs/album/activity_list.md)~~ + - [x] ~~[操作](docs/album/action.md)~~ + - [ ] ~~投稿~~ - [ ] [历史记录 & 稍后再看](docs/history&toview) - [x] [历史记录](docs/history&toview/history.md) - [x] [稍后再看](docs/history&toview/toview.md) From 654e296a05864e3be68a3871c16ae72b45294bff Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Sun, 20 Apr 2025 19:21:36 +0800 Subject: [PATCH 10/12] feat(CONTRIBUTING.md): add link to json-apidoc-gen --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1f47a73..6b867be 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -83,7 +83,7 @@ Telegram 交流群主要用作 [BAC 项目](https://github.com/SocialSisterYi/bi 文档使用 [VuePress](https://vuepress.vuejs.org/) 生成，可以使用 [VuePress Markdown 扩展语法](https://vuepress.vuejs.org/guide/markdown.html)编写 -注：以下文档范式主要针对接口类文档, 可根据**实际情况**进行调整, 你也可以使用 `json-apidoc-gen` 工具直接生成模板自行填充内容. 非接口类文档, 如算法等, 可以参考已有的内容 +注：以下文档范式主要针对接口类文档, 可根据**实际情况**进行调整, 你也可以使用 [`json-apidoc-gen`](https://github.com/SessionHu/json-apidoc-gen) 工具直接生成模板自行填充内容. 非接口类文档, 如算法等, 可以参考已有的内容 ### 头部 From ab2762aeaa0aad65603478ca704cd4cbc3b9c425 Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Mon, 21 Apr 2025 00:04:12 +0800 Subject: [PATCH 11/12] feat: mark all album doc as down --- docs/album/action.md | 6 +++++- docs/album/activity_list.md | 6 +++++- docs/album/info.md | 6 +++++- docs/album/list.md | 6 +++++- docs/album/recommend_author.md | 5 ++++- 5 files changed, 24 insertions(+), 5 deletions(-) diff --git a/docs/album/action.md b/docs/album/action.md index b209dad..1d42821 100644 --- a/docs/album/action.md +++ b/docs/album/action.md @@ -1,5 +1,8 @@ # 相簿操作 +<details> +<summary>功能已下线</summary> + ## ~~点赞相簿~~ > https://api.vc.bilibili.com/link_draw/v2/Vote/operate @@ -167,4 +170,5 @@ curl 'https://api.vc.bilibili.com/user_plus/v1/Fav/delete' \ } ``` -</details> \ No newline at end of file +</details> +</details> diff --git a/docs/album/activity_list.md b/docs/album/activity_list.md index 7d19044..4c82f37 100644 --- a/docs/album/activity_list.md +++ b/docs/album/activity_list.md @@ -1,5 +1,8 @@ # 相簿活动列表 +<details> +<summary>功能已下线</summary> + ## 获取相簿热门活动列表 > https://api.vc.bilibili.com/photo_activity/v2/Activity/list @@ -145,4 +148,5 @@ curl -G 'https://api.vc.bilibili.com/photo_activity/v2/Activity/list' \ } ``` -</details> \ No newline at end of file +</details> +</details> diff --git a/docs/album/info.md b/docs/album/info.md index a3059c0..5489857 100644 --- a/docs/album/info.md +++ b/docs/album/info.md @@ -1,5 +1,8 @@ # 相簿基本信息 +<details> +<summary>功能已下线</summary> + ## 获取相簿详细信息 >https://api.vc.bilibili.com/link_draw/v1/doc/detail @@ -242,4 +245,5 @@ curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/detail' \ } ``` -</details> \ No newline at end of file +</details> +</details> diff --git a/docs/album/list.md b/docs/album/list.md index 87d4aeb..44adb6f 100644 --- a/docs/album/list.md +++ b/docs/album/list.md @@ -1,5 +1,8 @@ # 相簿列表 +<details> +<summary>功能已下线</summary> + ## 获取画友首页列表 > https://api.vc.bilibili.com/link_draw/v2/Doc/index @@ -2431,4 +2434,5 @@ curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/others' \ } ``` -</details> \ No newline at end of file +</details> +</details> diff --git a/docs/album/recommend_author.md b/docs/album/recommend_author.md index d9122c6..ba57f07 100644 --- a/docs/album/recommend_author.md +++ b/docs/album/recommend_author.md @@ -1,5 +1,8 @@ # 相簿推荐作者 +<details> +<summary>功能已下线</summary> + ## 获取摄影推荐作者 > https://api.vc.bilibili.com/link_draw/v2/Photo/uper @@ -163,4 +166,4 @@ curl -G 'https://api.vc.bilibili.com/link_draw/v2/Doc/drawer' \ ``` </details> - +</details> From f6dc16f833b167bdf9c3e55a747983f21aae9431 Mon Sep 17 00:00:00 2001 From: SessionHu <102411014+SessionHu@users.noreply.github.com> Date: Mon, 21 Apr 2025 00:07:17 +0800 Subject: [PATCH 12/12] chore: move docs/history&toview to docs/historytoview --- README.md | 6 +++--- docs/{history&toview => historytoview}/history.md | 0 docs/{history&toview => historytoview}/toview.md | 0 3 files changed, 3 insertions(+), 3 deletions(-) rename docs/{history&toview => historytoview}/history.md (100%) rename docs/{history&toview => historytoview}/toview.md (100%) diff --git a/README.md b/README.md index 00da6b4..7215424 100644 --- a/README.md +++ b/README.md @@ -227,9 +227,9 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接 - [x] ~~[活动列表](docs/album/activity_list.md)~~ - [x] ~~[操作](docs/album/action.md)~~ - [ ] ~~投稿~~ -- [ ] [历史记录 & 稍后再看](docs/history&toview) - - [x] [历史记录](docs/history&toview/history.md) - - [x] [稍后再看](docs/history&toview/toview.md) +- [ ] [历史记录 & 稍后再看](docs/historytoview) + - [x] [历史记录](docs/historytoview/history.md) + - [x] [稍后再看](docs/historytoview/toview.md) - [ ] [收藏夹](docs/fav) - [x] [基本信息](docs/fav/info.md) - [x] [收藏夹内容](docs/fav/list.md) diff --git a/docs/history&toview/history.md b/docs/historytoview/history.md similarity index 100% rename from docs/history&toview/history.md rename to docs/historytoview/history.md diff --git a/docs/history&toview/toview.md b/docs/historytoview/toview.md similarity index 100% rename from docs/history&toview/toview.md rename to docs/historytoview/toview.md