mnapis

按原文找位置

Body {text(逐字照抄), page(必填), navigate?}。返回 {found,page,matchedText,algorithm,score}，须核对 matchedText。no_match 多为改写原文；page_unreadable 为页不可读。navigate:true 仅滚动（不高亮），跨文档不跳（navigated:false + different_document_open）。

POST
/documents/{id}/locate

Body {text(逐字照抄), page(必填), navigate?}。返回 {found,page,matchedText,algorithm,score}，须核对 matchedText。no_match 多为改写原文；page_unreadable 为页不可读。navigate:true 仅滚动（不高亮），跨文档不跳（navigated:false + different_document_open）。

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

文档 bookmd5

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "https://example.com/documents/string/locate" \  -H "Content-Type: application/json" \  -d '{    "text": "string",    "page": 0  }'
Empty

导出文档扁平 PDF POST

Body {topicid(必填，定标注层), selectedPageNos(真实 PDF 页，省略=全书，空数组拒), includeRelatedBlankPages?=true}。留白页由 native 隐式带上，不计数、不入 selectedPageNos（拒绝 66000+ 虚拟页）。输出到外部导出根 DocumentExports。只建文件不改数据。若已有导出在跑 429 EXPORT_BUSY。

写 AI 目录 / 切回原始目录 POST

写：{entries:[{title,page,level(0-7),anchor?}], confirm:true}，页码须递增，越级静默钳（adjustedLevels）。落 AI 目录位，原目录无损。回退：{useOriginal:true,confirm:true} 切回原始；{useAI:true,confirm:true} 切回 AI。快照救不了目录。真 dry-run（不带 confirm 回 422 + details.wouldWrite）。