Заметки

Справочник API

Markdown-заметки, хранящиеся локально на устройстве. Поддерживают тегирование, корзину/восстановление и экспорт.

Определения типов

bash

type Note {
  id: ID!
  title: String!
  content: String!            # Markdown body
  createdAt: String!          # ISO 8601
  updatedAt: String!
  trashed: Boolean!           # true when in trash
  tags: [Tag!]!
}

input NoteInput {
  title: String
  content: String
}

Операции

query

notes

Поиск заметок (заголовок + содержимое). Оставьте запрос пустым, чтобы перечислить все заметки, не находящиеся в корзине.

bash

query GetNotes($offset: Int!, $limit: Int!, $query: String!) {
  notes(offset: $offset, limit: $limit, query: $query) {
    id title content createdAt updatedAt trashed
    tags { id name }
  }
}

query

noteCount

Подсчитайте заметки, соответствующие запросу.

bash

query GetNoteCount($query: String!) {
  noteCount(query: $query)
}

query

note

Получите одну заметку по ID.

bash

query GetNote($id: ID!) {
  note(id: $id) { id title content createdAt updatedAt trashed tags { id name } }
}

mutation

saveNote

Создайте или обновите заметку. Передайте пустой id для создания; передайте существующий id для обновления.

bash

mutation SaveNote($id: ID!, $input: NoteInput!) {
  saveNote(id: $id, input: $input) { id title updatedAt }
}

mutation

saveFeedEntriesToNotes

Bulk-save feed entries matching a query as notes (title = feed entry title, content = "# <title>\n\n<body>"). Returns the saved feed entry IDs.

bash

mutation SaveFeedEntriesToNotes($query: String!) {
  saveFeedEntriesToNotes(query: $query)
}

mutation

trashNotes

Переместите заметки, соответствующие запросу, в корзину.

bash

mutation TrashNotes($query: String!) {
  trashNotes(query: $query)
}

mutation

restoreNotes

Восстановите заметки из корзины, соответствующие запросу.

bash

mutation RestoreNotes($query: String!) {
  restoreNotes(query: $query)
}

mutation

deleteNotes

Навсегда удалите заметки из корзины, соответствующие запросу. Работает только с уже находящимися в корзине заметками.

bash

mutation DeleteNotes($query: String!) {
  deleteNotes(query: $query)
}

mutation

exportNotes

Сериализуйте заметки, соответствующие запросу (включая теги), как JSON-строку для резервного копирования/переноса.

bash

mutation ExportNotes($query: String!) {
  exportNotes(query: $query)
}