list_notes

macOS

Zweck

Listet Notizen aus der Apple Notes-App auf. Optional nach Ordner filtern. Paginiert: „limit“ ist auf 500 pro Aufruf begrenzt, also blättern Sie mit „offset“ (offset=500 gibt Notizen 501-1000 zurück), anstatt nach einem größeren limit zu fragen. Die Antwort enthält „total“ (wie viele Notizen insgesamt übereinstimmen) und „has_more“ (ob nach dieser Seite noch etwas übrig ist), sodass Sie nie raten müssen, ob Sie alles haben – blättern Sie, bis „has_more“ falsch ist, was genau ist, selbst wenn „total_is_estimated“ angibt, dass die Anzahl nur eine untere Grenze ist. Um eine WHOLE-Bibliothek zu lesen, übergeben Sie order="id" – siehe Parameter order.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "properties": {
    "folder": {
      "type": "string"
    },
    "limit": {
      "default": "50",
      "description": "Notes per page (default 50, capped at 500). To get more, page with offset.",
      "type": "integer"
    },
    "offset": {
      "default": "0",
      "description": "How many notes to skip (default 0). offset=500 with limit=500 returns notes 501-1000. An offset past the end returns an empty page with has_more=false, not an error.",
      "minimum": 0,
      "type": "integer"
    },
    "order": {
      "default": "modified",
      "description": "order: \"modified\" (default) sorts newest-modified first — what you want to SHOW someone, but NOT safe for paging: modification date changes, so a note edited between two calls jumps to the front and another note is pushed past your cursor and never returned. \"id\" sorts by the note's immutable store id — stable, never renumbered, new notes append at the end — so use order=\"id\" to walk an entire library page by page: edits and insertions mid-crawl are safe with it. One case it cannot cover, because pages are addressed by offset: if a note is DELETED mid-crawl, every note after the hole shifts one slot back and the note that was on the page boundary is skipped, silently. If completeness matters, re-run the crawl and reconcile against total, or crawl while nothing is deleting notes.",
      "type": "string"
    }
  },
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für list_notes. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "limit": 5
}