mnapis

读文档页文本

?start=&end=（≤60 页/次）。start/end 与 prepare segments 同为 PDF 页序（第一页=1）。&blocks=1 变块探针（返回块清单 {index,text,label}，较慢，探 1-2 页）。读正文用它，不绕 prepare。

GET
/documents/{id}/pages

?start=&end=（≤60 页/次）。start/end 与 prepare segments 同为 PDF 页序（第一页=1）。&blocks=1 变块探针（返回块清单 {index,text,label}，较慢，探 1-2 页）。读正文用它，不绕 prepare。

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string

文档 bookmd5

Query Parameters

start?integer

起始 PDF 页（第一页=1）

end?integer

结束 PDF 页，单次 ≤60 页

blocks?integer

=1 变块探针，返回块清单（较慢，探 1-2 页）

Response Body

curl -X GET "https://example.com/documents/string/pages"
Empty

页视觉注释面 GET

?studySet= 仅调旧 blank map 解析优先级，仍合并该文档所在全部 topic（topicFilteringApplied:false）。返回 parts[]（可读图像清单）与 blanks[]（逻辑留白，contentIds 指向图像）。mapBacked:false 为恢复项。

单文档同步对账 GET

[?verifyHash=1]（默认不算 hash；verifyHash 会全文件扫描，大 PDF 慢）。以 state 为准：database_reference_without_document_mapping/waiting_for_icloud_download 且 hasLearningData判学习数据先行；library_record_only 勿称笔记已到；available_local_only 先看 expectedByCurrentSettings；verified_mismatch/icloud_error/mapped_but_not_materialized 才列异常。databaseQueryErrors 存在时为部分证据；全失败回 SYNC_DIAGNOSTIC_QUERY_FAILED。