> ## Documentation Index > Fetch the complete documentation index at: https://dev.marginnote.com.cn/llms.txt > Use this file to discover all available pages before exploring further. # 查询旧同步事件 > 按本设备的序号增量读取同步事件。一次取 1 到 200 条，默认 50 条。 续读时应将上一次响应中的 `lastSequence` 作为 `afterSequence` 传入。游标字段（`hasMore`、 `historyTruncated`、`cursorAdvancedPastGap`、`cursorAhead`）的含义见 `LegacySyncEventsResponse`。 ## OpenAPI ````yaml /openapi/plugin-api.yaml get /sync/legacy/events openapi: 3.1.0 info: title: 场景插件 API summary: 场景插件在网页面板里可以调用的接口。 description: > 场景插件的面板是一个网页。页面里向 `/bridge/v1` 发请求，就能读写 MarginNote 里的数据。 请求由 MarginNote 处理，与外部命令行工具共用同一套处理代码。外部工具要带令牌，面板不必带。 面板页面从 `mnpanel://panel/index.html` 加载，因此 `fetch('/bridge/v1' + path)` 属于同源请求。 面板调用受这些条件约束： - 请求不带令牌，本文件也不声明安全方案。 - 页面能调用哪些接口，取决于两份名单。模板里的 `plugins` 名单和沉浸态决定面板能不能建好， 网页面板白名单决定页面能调哪些接口。不在白名单里的请求返回 `403`， 错误码为 `IN_PROCESS_NOT_ALLOWED`。 - `GET /capabilities` 里的 `requiresMax` 只约束外部 Agent。面板的请求在 MarginNote 进程内处理， 不受令牌、订阅状态与跨设备批准的限制，能否调用只看该路径是否在白名单内。 - 写操作里的 `addon`，MarginNote 会改写为当前面板所属插件的 id；`confirm` 由 MarginNote 补上。 页面填的值不会生效。 用 `mn.api(path, opts)` 读取数据。该方法始终将 Response Body 按 JSON 解析，相当于 `fetch('/bridge/v1' + path, opts).then(r => r.json())`。 响应的内容不是 JSON 的接口，改用 `fetch`： - `GET /guide` 返回 Markdown 正文。 - `GET /notes/{noteid}/render` 返回卡片长图或 PDF。 - `GET /documents/{bookmd5}/pages/{index}/content/{contentId}` 返回图片。 - `GET /bundles/{bundleId}/files` 带 `?path=` 时返回该文件的原始字节。 调用失败时 Promise 不会进入 reject。MarginNote 把错误对象 `{"error":{"code":"…","message":"…"}}` 当作 Response Body 返回，因此结果落在 resolve 里。 判断调用结果看响应里是否带 `error`，写操作另看响应里的 `persisted`。 接口清单、各项上限与 Request Body 结构随 MarginNote 的版本变化，运行时以 `GET /capabilities` 与 `GET /guide` 返回的内容为准。 version: '0.91' servers: [] security: [] tags: - name: 能力与状态 description: 读取 MarginNote 的能力、版本与当前上下文。调用其他接口之前先读这组。 - name: 卡片与摘录 description: 卡片的读取与写入、摘录的创建、批注、标签、元数据与留白。 - name: 手写会话 description: 手写层、作答纸、练习准备清单与会话记录的读取与提交。 - name: 学习集与卡组 description: 学习集结构、脑图树、子脑图、色板、快照与复习卡组。 - name: 文档与页面 description: 文档目录、页文本、页内注释面、摘录清单与同步诊断。 - name: 导出与 Anki description: 文档导出计划、导出文件、Anki 导出能力、作业与产物。 - name: 查找 description: 跨库搜索、文件夹列表与学习集列表。 - name: 界面与模板 description: 读取当前界面状态与沉浸模板。 - name: 插件辅助 description: 面板辅助脚本、已配对设备与本机 helper 信息。 - name: 任务包与同步诊断 description: 拆书任务包与旧 CloudKit 同步诊断。 paths: /sync/legacy/events: get: tags: - 任务包与同步诊断 summary: 查询旧同步事件 description: > 按本设备的序号增量读取同步事件。一次取 1 到 200 条，默认 50 条。 续读时应将上一次响应中的 `lastSequence` 作为 `afterSequence` 传入。游标字段（`hasMore`、 `historyTruncated`、`cursorAdvancedPastGap`、`cursorAhead`）的含义见 `LegacySyncEventsResponse`。 operationId: getSyncLegacyEvents parameters: - $ref: '#/components/parameters/AfterSequence' - $ref: '#/components/parameters/EventLimit' responses: '200': description: 事件列表与游标状态。游标字段有据，事件条目结构未取到。 content: application/json: schema: $ref: '#/components/schemas/LegacySyncEventsResponse' examples: assembled: summary: 游标字段构造示例，事件条目为占位 value: events: - sequence: 1841 kind: noteChanged at: '2026-10-06T21:12:03Z' lastSequence: 1841 hasMore: false historyTruncated: false cursorAdvancedPastGap: false cursorAhead: false measured: summary: 实测于 2026-10-07，App 0.91 value: events: - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187594.5056992 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: settings_refreshed phase: configuration details: channel: 0 cloudEnabled: true containerAvailable: 1 appVersion: 4.5.0 sequence: 1 status: observed build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187594.506765 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: settings_refreshed phase: configuration details: channel: 0 cloudEnabled: true containerAvailable: 1 appVersion: 4.5.0 sequence: 2 status: observed build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187594.576504 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 1 reason: suspend_counter_incremented appVersion: 4.5.0 sequence: 3 status: paused build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187594.7222052 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: settings_refreshed phase: configuration details: channel: 0 cloudEnabled: true containerAvailable: 1 appVersion: 4.5.0 sequence: 4 status: observed build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187595.1749349 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 2 reason: suspend_counter_incremented appVersion: 4.5.0 sequence: 5 status: paused build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187595.179212 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 3 reason: suspend_counter_incremented appVersion: 4.5.0 sequence: 6 status: paused build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187595.182836 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 4 reason: suspend_counter_incremented appVersion: 4.5.0 sequence: 7 status: paused build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187595.1861029 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 3 reason: suspend_counter_decremented appVersion: 4.5.0 sequence: 8 status: paused build: '45044' - run: 8AA93B67-8C99-43C4-9B0B-4F47F7DC3D60 timestamp: 1788187596.26268 lane: documents schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: document_scan_finished phase: icloud_documents details: placeholderCount: 0 pendingCount: 0 channel: 0 scanState: 1 reason: '' containerAvailable: true appVersion: 4.5.0 sequence: 9 status: complete build: '45044' - run: 8AA93B67-8C99-43C4-9B0B-4F47F7DC3D60 timestamp: 1788187596.699839 lane: documents schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: document_coverage_reconciled phase: icloud_documents details: missingDocumentCount: 24 ordinaryPhysicalDocumentCount: 42 iCloudUploadErrorCount: 0 publishedToICloudCount: 13 manualScopeUnverifiedDocumentCount: 0 externalProviderOnlyCount: 0 referencedDocumentCount: 56 reason: '' pendingICloudUploadCount: 0 potentialRepairCandidateCount: 5 manualScopeUnverifiedTopicCount: 0 localOnlyDocumentCount: 5 specialDocumentUnresolvedCount: 10 iCloudPresenceUnverifiedCount: 0 appVersion: 4.5.0 sequence: 10 status: complete build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187597.3245769 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 2 reason: suspend_counter_decremented appVersion: 4.5.0 sequence: 11 status: paused build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187597.526756 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 1 reason: suspend_counter_decremented appVersion: 4.5.0 sequence: 12 status: paused build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187597.531328 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_fetch_started phase: fetch_changes details: source: incremental_token appVersion: 4.5.0 sequence: 13 status: running build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187597.683028 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_fetch_finished phase: fetch_changes details: bookConfigRecordCount: 0 mediaRecordCount: 0 deletedCount: 0 topicRecordCount: 0 changedCount: 0 errorDomain: '' otherRecordCount: 0 moreComing: false noteRecordCount: 0 errorCode: 0 appVersion: 4.5.0 sequence: 14 status: complete build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187597.6874151 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_token_stage_finished phase: cursor_persistence details: result: token_staged_with_pending_changes appVersion: 4.5.0 sequence: 15 status: complete build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187597.691041 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_apply_save_finished phase: apply_buffer details: result: database_and_apply_buffer_saved appVersion: 4.5.0 sequence: 16 status: complete build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187597.695189 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 0 reason: suspend_counter_decremented appVersion: 4.5.0 sequence: 17 status: resumed build: '45044' - run: E7E3F05B-078B-41D3-91F8-B9E222B2E6BF timestamp: 1788187598.366651 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_upload_finished phase: book_tags_upload details: savedCount: 0 errorCode: 0 errorDomain: '' deletedCount: 0 appVersion: 4.5.0 sequence: 18 status: complete build: '45044' - run: 97B0F072-504E-4D38-ACF5-E80E177FB320 timestamp: 1788191362.0652351 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 1 reason: suspend_counter_incremented appVersion: 4.5.0 sequence: 19 status: paused build: '45044' - run: 11FB83C9-BE65-483D-A079-084AA95787A6 timestamp: 1788260189.7542338 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_fetch_started phase: fetch_changes details: source: incremental_token appVersion: 4.5.0 sequence: 20 status: running build: '45044' - run: 11FB83C9-BE65-483D-A079-084AA95787A6 timestamp: 1788260196.0747418 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_fetch_finished phase: fetch_changes details: bookConfigRecordCount: 0 mediaRecordCount: 0 deletedCount: 0 topicRecordCount: 0 changedCount: 0 errorDomain: '' otherRecordCount: 0 moreComing: false noteRecordCount: 0 errorCode: 0 appVersion: 4.5.0 sequence: 21 status: complete build: '45044' - run: 11FB83C9-BE65-483D-A079-084AA95787A6 timestamp: 1788260195.070893 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_token_stage_finished phase: cursor_persistence details: result: token_staged_with_pending_changes appVersion: 4.5.0 sequence: 22 status: complete build: '45044' - run: 11FB83C9-BE65-483D-A079-084AA95787A6 timestamp: 1788260195.115668 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_apply_save_finished phase: apply_buffer details: result: database_and_apply_buffer_saved appVersion: 4.5.0 sequence: 23 status: complete build: '45044' - run: 11FB83C9-BE65-483D-A079-084AA95787A6 timestamp: 1788260195.144545 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 0 reason: forced_resume appVersion: 4.5.0 sequence: 24 status: resumed build: '45044' - run: AFDFA47E-603E-4403-9E03-A0EB89D883FB timestamp: 1788327014.735034 lane: documents schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: document_scan_finished phase: icloud_documents details: placeholderCount: 0 pendingCount: 0 channel: 0 scanState: 1 reason: '' containerAvailable: true appVersion: 4.5.0 sequence: 25 status: complete build: '45044' - run: AFDFA47E-603E-4403-9E03-A0EB89D883FB timestamp: 1788327015.649502 lane: documents schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: document_coverage_reconciled phase: icloud_documents details: missingDocumentCount: 24 ordinaryPhysicalDocumentCount: 42 iCloudUploadErrorCount: 0 publishedToICloudCount: 13 manualScopeUnverifiedDocumentCount: 0 externalProviderOnlyCount: 0 referencedDocumentCount: 56 reason: '' pendingICloudUploadCount: 0 potentialRepairCandidateCount: 5 manualScopeUnverifiedTopicCount: 0 localOnlyDocumentCount: 5 specialDocumentUnresolvedCount: 10 iCloudPresenceUnverifiedCount: 0 appVersion: 4.5.0 sequence: 26 status: complete build: '45044' - run: 6D675C34-1F66-4637-99A5-125FF4C0768D timestamp: 1788328984.666599 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 1 reason: suspend_counter_incremented appVersion: 4.5.0 sequence: 27 status: paused build: '45044' - run: 5C3E2AA9-7B74-4D41-95BD-10AA08744B3B timestamp: 1788329991.79673 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_fetch_started phase: fetch_changes details: source: incremental_token appVersion: 4.5.0 sequence: 28 status: running build: '45044' - run: 5C3E2AA9-7B74-4D41-95BD-10AA08744B3B timestamp: 1788329992.242183 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_fetch_finished phase: fetch_changes details: bookConfigRecordCount: 0 mediaRecordCount: 0 deletedCount: 0 topicRecordCount: 0 changedCount: 0 errorDomain: '' otherRecordCount: 0 moreComing: false noteRecordCount: 0 errorCode: 0 appVersion: 4.5.0 sequence: 29 status: complete build: '45044' - run: 5C3E2AA9-7B74-4D41-95BD-10AA08744B3B timestamp: 1788329992.247714 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_token_stage_finished phase: cursor_persistence details: result: token_staged_with_pending_changes appVersion: 4.5.0 sequence: 30 status: complete build: '45044' - run: 5C3E2AA9-7B74-4D41-95BD-10AA08744B3B timestamp: 1788329992.251569 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_apply_save_finished phase: apply_buffer details: result: database_and_apply_buffer_saved appVersion: 4.5.0 sequence: 31 status: complete build: '45044' - run: 5C3E2AA9-7B74-4D41-95BD-10AA08744B3B timestamp: 1788329992.2579908 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 0 reason: forced_resume appVersion: 4.5.0 sequence: 32 status: resumed build: '45044' - run: 054EF329-A6F8-46E8-9042-3EE334057513 timestamp: 1788412455.625986 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 1 reason: suspend_counter_incremented appVersion: 4.5.0 sequence: 33 status: paused build: '45044' - run: C656737D-7129-4B46-A5BB-2948AB23FFAA timestamp: 1788413513.740715 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_fetch_started phase: fetch_changes details: source: incremental_token appVersion: 4.5.0 sequence: 34 status: running build: '45044' - run: C656737D-7129-4B46-A5BB-2948AB23FFAA timestamp: 1788413527.3922482 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_fetch_finished phase: fetch_changes details: bookConfigRecordCount: 0 mediaRecordCount: 0 deletedCount: 0 topicRecordCount: 0 changedCount: 0 errorDomain: '' otherRecordCount: 0 moreComing: false noteRecordCount: 0 errorCode: 0 appVersion: 4.5.0 sequence: 35 status: complete build: '45044' - run: C656737D-7129-4B46-A5BB-2948AB23FFAA timestamp: 1788413528.028668 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_token_stage_finished phase: cursor_persistence details: result: token_staged_with_pending_changes appVersion: 4.5.0 sequence: 36 status: complete build: '45044' - run: C656737D-7129-4B46-A5BB-2948AB23FFAA timestamp: 1788413532.378007 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_apply_save_finished phase: apply_buffer details: result: database_and_apply_buffer_saved appVersion: 4.5.0 sequence: 37 status: complete build: '45044' - run: C656737D-7129-4B46-A5BB-2948AB23FFAA timestamp: 1788413534.801324 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_suspension_changed phase: suspension details: pendingCount: 0 reason: forced_resume appVersion: 4.5.0 sequence: 38 status: resumed build: '45044' - run: 8324FE68-DE8F-4970-A313-C3067E01D728 timestamp: 1788523306.727937 lane: documents schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: document_scan_finished phase: icloud_documents details: placeholderCount: 0 pendingCount: 0 channel: 0 scanState: 1 reason: '' containerAvailable: true appVersion: 4.5.0 sequence: 39 status: complete build: '45044' - run: 8324FE68-DE8F-4970-A313-C3067E01D728 timestamp: 1788523307.2404861 lane: documents schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: document_coverage_reconciled phase: icloud_documents details: missingDocumentCount: 24 ordinaryPhysicalDocumentCount: 42 iCloudUploadErrorCount: 0 publishedToICloudCount: 13 manualScopeUnverifiedDocumentCount: 0 externalProviderOnlyCount: 0 referencedDocumentCount: 56 reason: '' pendingICloudUploadCount: 0 potentialRepairCandidateCount: 5 manualScopeUnverifiedTopicCount: 0 localOnlyDocumentCount: 5 specialDocumentUnresolvedCount: 10 iCloudPresenceUnverifiedCount: 0 appVersion: 4.5.0 sequence: 40 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788523773.1943069 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_upload_finished phase: notebook_upload details: savedCount: 1 errorCode: 0 errorDomain: '' deletedCount: 0 appVersion: 4.5.0 sequence: 41 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788523773.199245 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_apply_save_finished phase: apply_buffer details: result: database_and_apply_buffer_saved appVersion: 4.5.0 sequence: 42 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788524207.723476 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_upload_finished phase: notebook_upload details: savedCount: 1 errorCode: 0 errorDomain: '' deletedCount: 0 appVersion: 4.5.0 sequence: 43 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788524207.73174 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_apply_save_finished phase: apply_buffer details: result: database_and_apply_buffer_saved appVersion: 4.5.0 sequence: 44 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788524212.584121 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_upload_finished phase: notebook_upload details: savedCount: 3 errorCode: 0 errorDomain: '' deletedCount: 0 appVersion: 4.5.0 sequence: 45 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788524212.601897 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_apply_save_finished phase: apply_buffer details: result: database_and_apply_buffer_saved appVersion: 4.5.0 sequence: 46 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788524275.843556 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_upload_finished phase: notebook_upload details: savedCount: 1 errorCode: 0 errorDomain: '' deletedCount: 0 appVersion: 4.5.0 sequence: 47 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788524275.86169 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_apply_save_finished phase: apply_buffer details: result: database_and_apply_buffer_saved appVersion: 4.5.0 sequence: 48 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788524279.598145 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_upload_finished phase: notebook_upload details: savedCount: 2 errorCode: 0 errorDomain: '' deletedCount: 0 appVersion: 4.5.0 sequence: 49 status: complete build: '45044' - run: EC985B9A-AF12-40A0-B1A9-48B8C1E820CF timestamp: 1788524279.614552 lane: cloudkit schema: 2 session: 1E421E36-9F79-4F1B-96DE-06F813139062 event: cloudkit_apply_save_finished phase: apply_buffer details: result: database_and_apply_buffer_saved appVersion: 4.5.0 sequence: 50 status: complete build: '45044' hasMore: true historyTruncated: false privacy: containsAccountIdentifiers: false containsDocumentNames: false containsNoteContent: false containsRecordIdentifiers: false lastSequence: 50 cursorAdvancedPastGap: false limit: 50 currentSequence: 495 afterSequence: 0 cursorAhead: false bridgeApiVersion: '0.91' x-codeSamples: - lang: javascript label: 增量轮询旧同步事件 source: | let after = 0; for (;;) { const r = await mn.api('/sync/legacy/events?afterSequence=' + after + '&limit=50'); if (r.error) break; after = r.lastSequence; if (!r.hasMore) break; } components: parameters: AfterSequence: name: afterSequence in: query required: false description: 从该序号之后开始读。取上一页响应里的 `lastSequence`。 schema: type: integer minimum: 0 EventLimit: name: limit in: query required: false description: 一次返回的事件条数。 schema: type: integer minimum: 1 maximum: 200 default: 50 schemas: LegacySyncEventsResponse: type: object properties: events: type: array items: type: object additionalProperties: true lastSequence: type: number description: 继续取时用作 `afterSequence`。 hasMore: type: boolean description: 为 `true` 表示还有可取的事件。 historyTruncated: type: boolean description: 起点已早于本机的滚动记录窗口，或窗口内出现过记录缺口。此时不能声称中间阶段是完整的。 cursorAdvancedPastGap: type: boolean description: 缺口之后已无事件可返回，MarginNote 将游标推至当前位置，避免调用方反复请求空结果。 cursorAhead: type: boolean description: 表示调用方的游标与当前资料库或设备不符，游标应当重置。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.