list_notes

macOS

Objectif

Répertorie les notes de l'application Apple Notes. Filtrez éventuellement par dossier. Paginé : `limit` est plafonné à 500 par appel, donc page avec `offset` (offset=500 renvoie les notes 501-1000) au lieu de demander un limit plus grand. La réponse contient « total » (combien de notes correspondent au total) et « has_more » (si quelque chose reste après cette page), vous n'avez donc jamais à deviner si vous avez tout obtenu - page jusqu'à ce que « has_more » soit faux, ce qui est exact même lorsque « total_is_estimated » indique que le nombre n'est qu'une limite inférieure. Pour lire une bibliothèque WHOLE, transmettez order="id" — voir le paramètre order.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

{
  "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"
}

Exemple documentaire

Exemple de documentation pour list_notes. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "limit": 5
}