list_notes

macOS

Finalidade

Lista notas do aplicativo Apple Notes. Opcionalmente, filtre por pasta. Paginado: `limit` tem um limite de 500 por chamada, então paginar com `offset` (offset=500 retorna notas 501-1000) em vez de solicitar um limit maior. A resposta contém `total` (quantas notas correspondem ao todo) e `has_more` (se alguma coisa foi deixada além desta página), então você nunca precisa adivinhar se obteve tudo - página até que `has_more` seja falso, o que é exato mesmo quando `total_is_estimated` diz que a contagem é apenas um limite inferior. Para ler uma biblioteca WHOLE, passe order="id" — veja o parâmetro order.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

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

Exemplo documental

Exemplo de documentação para list_notes. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "limit": 5
}