mnapis

全库搜索

?q=&scope=all|notes|studysets|documents。返回卡/集/文档三类命中。无列全库文档端点，找书用 scope=documents 拿 bookmd5。响应带 scanned/truncated；truncated:true=窗口没够到，加词重搜。新卡约 10s 索引延迟。

GET
/search

?q=&scope=all|notes|studysets|documents。返回卡/集/文档三类命中。无列全库文档端点，找书用 scope=documents 拿 bookmd5。响应带 scanned/truncated；truncated:true=窗口没够到，加词重搜。新卡约 10s 索引延迟。

Authorization

bearerAuth
AuthorizationBearer <token>

安装脚本写入 ~/.config/mn-bridge/token，或环境变量 MN_BRIDGE_TOKEN。不要带 Origin 头。

In: header

Query Parameters

q*string

关键词；truncated:true 时加词缩小范围重搜

scope?string

all|notes|studysets|documents

Value in

  • "all"
  • "notes"
  • "studysets"
  • "documents"

Response Body

curl -X GET "https://example.com/search?q=string"
Empty

回退快照 POST

Body {confirm:true(, force:true 若 USER_EDITS_PRESENT 且用户确认覆盖)}。回退整集到过去，自动先打回退前保护点（protectionSnapshotId）。目标集正开着回 409 STUDY_SET_IN_USE（切走再试）。文档目录不在快照覆盖范围。真 dry-run（422 + wouldRestoreToVersion/快照时间/说明/卡数）。

旧同步增量事件 GET

?afterSequence=N&limit=50（1..200）。用 lastSequence 续取；hasMore 续取；historyTruncated=窗口外/缺口（勿称完整）；cursorAdvancedPastGap=已推游标防死循环；cursorAhead=换 channel/设备（重置游标）。