提交导入(commit)
Body {targetParentNoteId?, withBlank?, excerptMode?:child|link, resultMarkdown?(仅跨设备)}。无 confirm 门,发即真执行。返回 {rootNoteId, version, preImportSnapshotId(存好,USER_EDITS_PRESENT 时带 force:true 才覆盖), receipt, parsed{headings,importedCards,wikilinks,excerptsTotal,excerptsAnchored,failedExcerpts[]}, warnings, excerptStatsTruncated?, blankInsertion?}。headings≠importedCards 即丢卡;excerptsAnchored 不等即有未定位摘录(no_match 多为改写原文)。并发重复提交 409 SUBMIT_IN_FLIGHT。
Body {targetParentNoteId?, withBlank?, excerptMode?:child|link, resultMarkdown?(仅跨设备)}。无 confirm 门,发即真执行。返回 {rootNoteId, version, preImportSnapshotId(存好,USER_EDITS_PRESENT 时带 force:true 才覆盖), receipt, parsed{headings,importedCards,wikilinks,excerptsTotal,excerptsAnchored,failedExcerpts[]}, warnings, excerptStatsTruncated?, blankInsertion?}。headings≠importedCards 即丢卡;excerptsAnchored 不等即有未定位摘录(no_match 多为改写原文)。并发重复提交 409 SUBMIT_IN_FLIGHT。
Authorization
bearerAuth 安装脚本写入 ~/.config/mn-bridge/token,或环境变量 MN_BRIDGE_TOKEN。不要带 Origin 头。
In: header
Path Parameters
任务包 bundleId
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://example.com/bundles/string/submit" \ -H "Content-Type: application/json" \ -d '{}'聚焦导入结果 POST
无 confirm 门。异步,事后 /context 对账。
准备拆书任务包 POST
Body {topicid, bookmd5, segments[{startPage,endPage,title}](PDF 页序,非连续可,实际页数≤60), preset(book-breakdown|source-structure|exam-general|dictionary), anchorMode(page_text|block), title?, cardStyle{defaultFillIndex -1..2}?, async?}。>~10 页必 async:true(202 {jobId,bundleId,bundlePath,state:preparing} + 轮询 GET /bundles;参数错同步 404/422)。单飞(429 PREPARE_BUSY 看 details.runningJob/retryAfterSeconds)。exam-general 必须配 block(含 role 标注),否则静默退化;错配 0.18+ 回 warnings(停下改组合重 prepare)。同步小包阻塞到完工(curl ≥300s)。