diff --git a/note/action.md b/note/action.md
index 4d2b536..f8bdb84 100644
--- a/note/action.md
+++ b/note/action.md
@@ -15,17 +15,22 @@
**正文参数( application/x-www-form-urlencoded ):**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
-| aid | num | 目标稿件avid | 必要 | |
-| note_id | num | 笔记id | 非必要 | 创建时无需此项 |
-| title | str | 笔记标题 | 必要 | |
-| summary | str | 笔记预览文本 | 必要 | |
-| content | str | 笔记正文json序列 | 必要 | 格式见[附表](readme.md#附表-笔记正文序列格式) |
-| tags | str | 笔记跳转标签列表 | 非必要 | |
-| cls | num | 1 | 非必要 | 作用尚不明确 |
-| from | str | 提交类型 | 非必要 | auto:自动提交
save:手动提交
close:关闭时自动提交 |
-| csrf | str | CSRF Token(位于cookie) | 必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
+| 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`自动提交
`save`手动提交
`close`关闭时自动提交 |
+| cont_len | num | 正文字数 | 非必要 | |
+| platform | str | 平台 | 非必要 | 可为`web` |
+| publish | num | 是否公开笔记 | 非必要 | `0`不公开
`1`公开 |
+| auto_comment | num | 是否添加到评论区 | 非必要 | `0`不添加
`1`添加 |
+| csrf | str | CSRF Token(位于cookie) | 必要 | |
**json回复:**
@@ -33,7 +38,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
79508:该稿件已存在笔记,无法新增 |
+| code | num | 返回值 | `0`成功
`-101`账号未登录
`-111`csrf校验失败
`-400`请求错误
`79508`该稿件已存在笔记,无法新增
`79513`笔记所属视频不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
@@ -50,7 +55,8 @@
```shell
curl 'http://api.bilibili.com/x/note/add' \
---data-urlencode 'aid=970322090' \
+--data-urlencode 'oid=970322090' \
+--data-urlencode 'oid_type=0' \
--data-urlencode 'note_id=3809605586518023'
--data-urlencode 'title=周刊哔哩哔哩排行榜#543'
--data-urlencode 'summary=STRONG'
@@ -90,7 +96,7 @@ curl 'http://api.bilibili.com/x/note/add' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------------------ | ------ | ---- |
-| aid | num | 目标稿件avid | 必要 | |
+| oid | num | 目标稿件avid | 必要 | |
| note_id | num | 笔记id | 非必要 | |
| csrf | str | CSRF Token(位于cookie) | 必要 | |
@@ -110,7 +116,7 @@ curl 'http://api.bilibili.com/x/note/add' \
```shell
curl 'http://api.bilibili.com/x/note/del' \
---data-urlencode 'aid=457253380' \
+--data-urlencode 'oid=457253380' \
--data-urlencode 'note_id=4075968478576647' \
--data-urlencode 'csrf=xxx'
-b 'SESSDATA=xxx'
@@ -118,8 +124,6 @@ curl 'http://api.bilibili.com/x/note/del' \
查看响应示例:
-
-
```json
{
"code": 0,
diff --git a/note/info.md b/note/info.md
index 9fb1505..962db9d 100644
--- a/note/info.md
+++ b/note/info.md
@@ -1,88 +1,65 @@
# 笔记详细信息
-- [查询视频笔记](#查询视频笔记)
-- [查询笔记内容](#查询笔记内容)
+- [查询该稿件是否禁止笔记](#查询该稿件是否禁止笔记)
+- [查询私有笔记内容](#查询私有笔记内容)
+- [查询公开笔记内容](#查询公开笔记内容)
---
-## 查询视频笔记
+## 查询该稿件是否禁止笔记
-> http://api.bilibili.com/x/note/list/archive
+> http://api.bilibili.com/x/note/is_forbid
*请求方式:GET*
-认证方式:Cookie(SESSDATA)
-
**url参数:**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------- | ---- | ------------ | ----------- | -------- |
-| aid | num | 稿件avid | 必要(可选) | avid与bvid任选一个 |
-| bvid | str | 稿件bvid | 必要(可选) | avid与bvid任选一个 |
-| csrf | str | CSRF Token(位于cookie) | 非必要 | |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | -------- | ------ | ---- |
+| aid | num | 稿件avid | 必要 | |
**json回复:**
根对象:
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | --------------------------------------------------- |
-| code | num | 返回值 | 0:成功
-400:请求错误
-101:账号未登录 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | |
-| data | obj | 信息本体 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------- |
+| code | num | 返回值 | `0`成功
`-400`请求错误 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
`data`对象:
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ----- | -------- | -------------------------------------------------- |
-| noteIds | array | 笔记列表 | 无笔记则无此项
可能后续会允许视频添加多个笔记 |
-
-`data`中的`noteIds`数组:
-
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | ----------- | ---------------- |
-| 0 | num | 笔记id | |
+| 字段 | 类型 | 内容 | 备注 |
+| -------------------- | ---- | ------------ | ----------------------------------- |
+| forbid_note_entrance | bool | 是否禁止笔记 | `true`禁止笔记
`false`允许笔记 |
**示例:**
-查询视频`av970322090`/`BV1op4y167Uo`的笔记id
-
-avid方式:
+查询视频稿件`av338677252`是否禁止笔记
```shell
-curl 'http://api.bilibili.com/x/note/list/archive' \
---data-urlencode 'aid=970322090' \
--b 'SESSDATA=xxx'
-```
-
-bvid方式:
-
-```shell
-curl 'http://api.bilibili.com/x/note/list/archive' \
---data-urlencode 'bvid=BV1op4y167Uo' \
--b 'SESSDATA=xxx'
+curl 'http://api.bilibili.com/x/note/info' \
+--data-urlencode 'aid=338677252'
```
查看响应示例:
-
```json
{
- "code":0,
- "message":"0",
- "ttl":1,
- "data":{
- "noteIds":[
- 3809605586518023
- ]
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "forbid_note_entrance": false
}
}
```
-## 查询笔记内容
+## 查询私有笔记内容
> http://api.bilibili.com/x/note/info
@@ -94,32 +71,47 @@ curl 'http://api.bilibili.com/x/note/list/archive' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ---------- | ----------- | -------- |
-| aid | num | 稿件avid | 必要(可选)| avid与bvid任选一个,不与笔记所属稿件avid相同不影响返回 |
-| bvid | str | 稿件bvid | 必要(可选)| avid与bvid任选一个,不与笔记所属稿件bvid相同不影响返回 |
+| oid | num | 目标id | 必要 | |
+| oid_type | num | 目标id类型 | 必要 | `0`视频(oid=avid) |
| note_id | num | 笔记id | 必要 | |
**json回复:**
根对象:
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | --------------------------------------------------- |
-| code | num | 返回值 | 0:成功
-400:请求错误
-101:账号未登录
79502:笔记详情未找到|
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | |
-| data | obj | 信息本体 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | `0`成功
`-400`请求错误
`-101`账号未登录
`79502`笔记详情未找到
`79503`笔记正文未找到 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | ---------------- | -------------- |
-| title | str | 笔记标题 | |
-| summary | str | 笔记预览文本 | |
-| content | str | 笔记正文json序列 | 格式见[附表](readme.md#附表-笔记正文序列格式) |
-| tags | array | 笔记跳转标签列表 | |
-| cid_count | num | 视频分P数 | |
+| arc | obj | 对应视频稿件信息 | |
| audit_status | num | 0 | 作用暂不明确 |
-| aid | num | 稿件avid | |
+| 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`数组:
@@ -141,23 +133,13 @@ curl 'http://api.bilibili.com/x/note/list/archive' \
**示例:**
-查询视频`av583785685`/`BV1kz4y1X7XP`中笔记`7165769906913287`的内容
-
-avid方式:
+查询视频`av338677252`中笔记`24508729145690112`的内容
```shell
curl 'http://api.bilibili.com/x/note/info' \
---data-urlencode 'aid=583785685' \
---data-urlencode 'note_id=7165769906913287' \
--b 'SESSDATA=xxx'
-```
-
-bvid方式:
-
-```shell
-curl 'http://api.bilibili.com/x/note/info' \
---data-urlencode 'bvid=BV1kz4y1X7XP' \
---data-urlencode 'note_id=7165769906913287' \
+--data-urlencode 'oid=338677252' \
+--data-urlencode 'oid_type=0' \
+--data-urlencode 'note_id=24508729145690112' \
-b 'SESSDATA=xxx'
```
@@ -166,28 +148,165 @@ curl 'http://api.bilibili.com/x/note/info' \
```json
{
- "code":0,
- "message":"0",
- "ttl":1,
- "data":{
- "title":"【cmd】访问api 命令行也能上B站",
- "summary":"项目介绍 才324个star?哦7月4日没事了 二维码登录流程介绍 正式开",
- "content":"{
- "insert":{
- "tag":{
- "cid":209620774,
- "status":0,
- "index":1,
- "seconds":5,
- "cidCount":1,
- "key":"1611921905204",
- "title":"【cmd】访问api 命令行也能上B站_x264"
- }
+ "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": ""
+ }
+ }
+}
+```
+
+
+
+## 查询公开笔记内容
+
+> http://api.bilibili.com/x/note/publish/info
+
+*请求方式:GET*
+
+**url参数:**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ------------------ | ------ | -------- |
+| cvid | num | 笔记对应的专栏cvid | 必要 | 非笔记id |
+
+**json回复:**
+
+根对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ---------------------------------------------------------- |
+| code | num | 返回值 | `0`成功
`-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 'http://api.bilibili.com/x/note/publish/info' \
+--data-urlencode 'cvid=15160286'
+```
+
+
+查看响应示例:
+
+
+```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": ""
}
- }..."
- "cid_count":1,
- "audit_status":0,
- "aid":583785685
+ },
+ "forbid_note_entrance": false
}
}
```
diff --git a/note/list.md b/note/list.md
index 3240e77..883d939 100644
--- a/note/list.md
+++ b/note/list.md
@@ -1,8 +1,82 @@
# 笔记列表
-- [查询所有笔记列表](#查询笔记列表)
+- [查询稿件私有笔记](#查询稿件私有笔记)
+- [查询用户私有笔记](#查询用户私有笔记)
+- [查询稿件公开笔记](#查询稿件公开笔记)
+- [查询用户公开笔记](#查询用户公开笔记)
-## 查询所有笔记列表
+---
+
+## 查询稿件私有笔记
+
+> http://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:成功
-400:请求错误
-101:账号未登录 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+`data`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----- | -------- | -------------------------------------------------- |
+| noteIds | array | 笔记列表 | 无笔记则无此项
可能后续会允许视频添加多个笔记 |
+
+`data`中的`noteIds`数组:
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ------ | ---- |
+| 0 | str | 笔记id | |
+
+**示例:**
+
+查询视频`av970322090`的笔记id
+
+```shell
+curl 'http://api.bilibili.com/x/note/list/archive' \
+--data-urlencode 'oid=970322090' \
+--data-urlencode 'oid_type=0' \
+-b 'SESSDATA=xxx'
+```
+
+
+查看响应示例:
+```json
+{
+ "code":0,
+ "message":"0",
+ "ttl":1,
+ "data":{
+ "noteIds":[
+ "3809605586518023"
+ ]
+ }
+}
+```
+
+
+
+## 查询用户私有笔记
> http://api.bilibili.com/x/note/list
@@ -46,24 +120,32 @@
`list`中的对象:
-| 字段 | 类型 | 内容 | 备注 |
-| --------------- | ---- | ------------ | ---------------------- |
-| title | str | 笔记标题 | |
-| summary | str | 笔记预览文本 | |
-| mtime | str | 提交时间 | |
-| arc | obj | 视频信息 | |
-| note_id | num | 笔记id | |
-| audit_status | num | 0 | 作用尚不明确 |
+| 字段 | 类型 | 内容 | 备注 |
+| -------------------- | ---- | ------------ | ------------------------- |
+| 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`中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | ---------------------- |
-| aid | num | 稿件avid | |
+| 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`对象:
@@ -75,8 +157,6 @@
**示例:**
-获取笔记列表
-
```shell
curl 'http://api.bilibili.com/x/note/list' \
--data-urlencode 'ps=10' \
@@ -89,44 +169,488 @@ curl 'http://api.bilibili.com/x/note/list' \
```json
{
- "code":0,
- "message":"0",
- "ttl":1,
- "data":{
- "list":[
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": [
{
- "title":"周刊哔哩哔哩排行榜#543",
- "summary":"test",
- "mtime":"2020-11-23 17:45",
- "arc":{
- "aid":970322090,
- "bvid":"BV1op4y167Uo",
- "pic":"http://i1.hdslb.com/bfs/archive/cc67f9c9b70d6eb97f00e726517c8c3da540ee05.jpg",
- "desc":"20年11月第3周 | 【PICK UP】栏目欢迎继续推荐,私信@周刊娘 ,附上推荐投稿的av/bv号与理由。请勿刷屏、引战",
- "status":0
+ "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":3809605586518023,
- "audit_status":0
- },
- {
- "title":"【MV】保加利亚妖王AZIS视频合辑",
- "summary":"test2",
- "mtime":"2020-11-20 16:44",
- "arc":{
- "aid":170001,
- "bvid":"BV17x411w7KC",
- "pic":"http://i2.hdslb.com/bfs/archive/1ada8c32a9d168e4b2ee3e010f24789ba3353785.jpg",
- "desc":"sina 保加利亚超级天王 Azis1999年出道。他的音乐融合保加利亚名族曲风chalga和pop、rap等元素,不过他惊艳的易装秀与浮夸的角色诠释才是他最为出名的地方 Azis与众多保加利亚天王天后级歌手都有过合作.06年,他作为Mariana Popova的伴唱,在欧洲半决赛上演唱了他们的参赛曲Let Me Cry 06年他被Velikite Balgari评为保加利亚有史以来最伟大的名人之一",
- "status":0
- },
- "note_id":3988570796195843,
- "audit_status":0
+ "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":2,
- "size":10,
- "num":1
+ "page": {
+ "total": 1,
+ "size": 10,
+ "num": 1
+ }
+ }
+}
+```
+
+
+
+## 查询稿件公开笔记
+
+> http://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:成功
-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 'http://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'
+```
+
+
+查看响应示例:
+
+
+```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": ""
+ }
+}
+```
+
+
+
+## 查询用户公开笔记
+
+> http://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:成功
-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 'http://api.bilibili.com/x/note/publish/list/user' \
+--data-urlencode 'ps=10' \
+--data-urlencode 'pn=1'
+-b 'SESSDATA=xxx'
+```
+
+
+查看响应示例:
+
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "page": {
+ "total": 0,
+ "size": 10,
+ "num": 1
}
}
}
diff --git a/note/readme.md b/note/readme.md
index 767a5a0..dbf0223 100644
--- a/note/readme.md
+++ b/note/readme.md
@@ -2,7 +2,9 @@
2020-11-16 B站推出了测试版的功能——"视频笔记",与视频稿件关联,为富文本模式,可供记录观看视频时的感悟以及视频中的重要内容,目前只可在web端操作
-目前单个稿件只能添加一篇笔记(与分P无关)
+笔记分为私有笔记和公开笔记,一个稿件只能添加一篇私有笔记,但可以公开多篇笔记
+
+公开笔记与【专栏】性质相同,使用`cvid`寻址相应的公开笔记
---