모든 도구

list_notes

메모 · macOS

효과: 읽기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

Apple 메모 앱의 메모를 나열하며 선택적으로 폴더로 필터링합니다. 페이지 매김: `limit`은 호출당 최대 500이므로 더 큰 값을 요청하지 말고 `offset`으로 넘겨보세요(offset=500이면 501~1000번째 메모). 응답의 `total`은 전체 일치 메모 수이고 `has_more`는 이 페이지 뒤에 남은 항목이 있는지를 나타내므로 전부 받았는지 추측할 필요가 없습니다. `total_is_estimated`가 하한 추정치라고 해도 `has_more`가 false가 될 때까지 넘기면 정확합니다. 전체 라이브러리를 읽으려면 order="id"를 전달하세요. 자세한 내용은 order 매개변수를 참조하세요.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

영문 정식 기술 스키마macOS
{
  "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"
}

문서 예시

list_notes 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "limit": 5
}