Skip to content

Latest commit

 

History

History
130 lines (99 loc) · 5.29 KB

action.md

File metadata and controls

130 lines (99 loc) · 5.29 KB

笔记操作

保存视频笔记

https://api.bilibili.com/x/note/add

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数( application/x-www-form-urlencoded ):

参数名 类型 内容 必要性 备注
oid num 目标id 必要
oid_type num 目标id类型 必要 0视频(oid=avid)
note_id num 笔记id 非必要 创建时无需此项
title str 笔记标题 必要
summary str 笔记预览文本 必要
content str 笔记正文json序列 必要 格式见附表
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回复:

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-101账号未登录
-111csrf校验失败
-400请求错误
79508该稿件已存在笔记,无法新增
79513笔记所属视频不合法
message str 错误信息 默认为0
ttl num 1
data obj 数据本体

data对象:

字段 类型 内容 备注
note_id num 笔记id

示例:

保存内容为加粗的STRONG的笔记3809605586518023av970322090

curl 'https://api.bilibili.com/x/note/add' \
--data-urlencode 'oid=970322090' \
--data-urlencode 'oid_type=0' \
--data-urlencode 'note_id=3809605586518023'
--data-urlencode 'title=周刊哔哩哔哩排行榜#543'
--data-urlencode 'summary=STRONG'
--data-urlencode 'content=[{"attributes":{"bold":true},"insert":"STRONG"},{"insert":"\n"}]'
--data-urlencode 'tags='
--data-urlencode 'cls=1'
--data-urlencode 'from=save'
--data-urlencode 'csrf=xxx'
-b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "note_id": 3809605586518023
  }
}

删除视频笔记

https://api.bilibili.com/x/note/del

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数( application/x-www-form-urlencoded ):

参数名 类型 内容 必要性 备注
oid num 目标稿件avid 必要
note_id num 笔记id 非必要
csrf str CSRF Token(位于cookie) 必要

json回复:

根对象:

字段 类型 内容 备注
code num 返回值 0:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
message str 错误信息 默认为0
ttl num 1

示例:

删除稿件av457253380下的笔记4075968478576647

curl 'https://api.bilibili.com/x/note/del' \
--data-urlencode 'oid=457253380' \
--data-urlencode 'note_id=4075968478576647' \
--data-urlencode 'csrf=xxx'
-b 'SESSDATA=xxx'
查看响应示例: ```json { "code": 0, "message": "0", "ttl": 1 } ```