import{_ as e,c as a,b as l,a as d,d as n,e as o,w as r,r as i,o as p}from"./app-Dgsdh8A6.js";const u={};function c(D,s){const t=i("RouteLink");return p(),a("div",null,[s[20]||(s[20]=l("h1",{id:"笔记操作",tabindex:"-1"},[l("a",{class:"header-anchor",href:"#笔记操作"},[l("span",null,"笔记操作")])],-1)),s[21]||(s[21]=l("h2",{id:"保存视频笔记",tabindex:"-1"},[l("a",{class:"header-anchor",href:"#保存视频笔记"},[l("span",null,"保存视频笔记")])],-1)),s[22]||(s[22]=l("blockquote",null,[l("p",null,"https://api.bilibili.com/x/note/add")],-1)),s[23]||(s[23]=l("p",null,[l("em",null,"请求方式：POST")],-1)),s[24]||(s[24]=l("p",null,"认证方式：Cookie（SESSDATA）",-1)),s[25]||(s[25]=l("p",null,[l("strong",null,"正文参数（ application/x-www-form-urlencoded ）：")],-1)),l("table",null,[s[19]||(s[19]=l("thead",null,[l("tr",null,[l("th",null,"参数名"),l("th",null,"类型"),l("th",null,"内容"),l("th",null,"必要性"),l("th",null,"备注")])],-1)),l("tbody",null,[s[6]||(s[6]=l("tr",null,[l("td",null,"oid"),l("td",null,"num"),l("td",null,"目标id"),l("td",null,"必要"),l("td")],-1)),s[7]||(s[7]=l("tr",null,[l("td",null,"oid_type"),l("td",null,"num"),l("td",null,"目标id类型"),l("td",null,"必要"),l("td",null,[l("code",null,"0"),n("视频(oid=avid)")])],-1)),s[8]||(s[8]=l("tr",null,[l("td",null,"note_id"),l("td",null,"num"),l("td",null,"笔记id"),l("td",null,"非必要"),l("td",null,"创建时无需此项")],-1)),s[9]||(s[9]=l("tr",null,[l("td",null,"title"),l("td",null,"str"),l("td",null,"笔记标题"),l("td",null,"必要"),l("td")],-1)),s[10]||(s[10]=l("tr",null,[l("td",null,"summary"),l("td",null,"str"),l("td",null,"笔记预览文本"),l("td",null,"必要"),l("td")],-1)),l("tr",null,[s[2]||(s[2]=l("td",null,"content",-1)),s[3]||(s[3]=l("td",null,"str",-1)),s[4]||(s[4]=l("td",null,"笔记正文json序列",-1)),s[5]||(s[5]=l("td",null,"必要",-1)),l("td",null,[s[1]||(s[1]=n("格式见")),o(t,{to:"/docs/note/#%E9%99%84%E8%A1%A8-%E7%AC%94%E8%AE%B0%E6%AD%A3%E6%96%87%E5%BA%8F%E5%88%97%E6%A0%BC%E5%BC%8F"},{default:r(()=>s[0]||(s[0]=[n("附表")])),_:1,__:[0]})])]),s[11]||(s[11]=l("tr",null,[l("td",null,"tags"),l("td",null,"str"),l("td",null,"笔记跳转标签列表"),l("td",null,"非必要"),l("td")],-1)),s[12]||(s[12]=l("tr",null,[l("td",null,"cls"),l("td",null,"num"),l("td",null,"1"),l("td",null,"非必要"),l("td",null,"作用尚不明确")],-1)),s[13]||(s[13]=l("tr",null,[l("td",null,"from"),l("td",null,"str"),l("td",null,"提交类型"),l("td",null,"非必要"),l("td",null,[l("code",null,"auto"),n("自动提交"),l("br"),l("code",null,"save"),n("手动提交"),l("br"),l("code",null,"close"),n("关闭时自动提交")])],-1)),s[14]||(s[14]=l("tr",null,[l("td",null,"cont_len"),l("td",null,"num"),l("td",null,"正文字数"),l("td",null,"非必要"),l("td")],-1)),s[15]||(s[15]=l("tr",null,[l("td",null,"platform"),l("td",null,"str"),l("td",null,"平台"),l("td",null,"非必要"),l("td",null,[n("可为"),l("code",null,"web")])],-1)),s[16]||(s[16]=l("tr",null,[l("td",null,"publish"),l("td",null,"num"),l("td",null,"是否公开笔记"),l("td",null,"非必要"),l("td",null,[l("code",null,"0"),n("不公开"),l("br"),l("code",null,"1"),n("公开")])],-1)),s[17]||(s[17]=l("tr",null,[l("td",null,"auto_comment"),l("td",null,"num"),l("td",null,"是否添加到评论区"),l("td",null,"非必要"),l("td",null,[l("code",null,"0"),n("不添加"),l("br"),l("code",null,"1"),n("添加")])],-1)),s[18]||(s[18]=l("tr",null,[l("td",null,"csrf"),l("td",null,"str"),l("td",null,"CSRF Token（位于cookie）"),l("td",null,"必要"),l("td")],-1))])]),s[26]||(s[26]=d(`json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|
| code | num | 返回值 | 0成功
-101账号未登录
-111csrf校验失败
-400请求错误
79508该稿件已存在笔记，无法新增
79513笔记所属视频不合法 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
data对象：
示例：
保存内容为加粗的STRONG的笔记3809605586518023于av970322090
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'
查看响应示例：
{
"code": 0,
"message": "0",
"ttl": 1
}