API 참조

Bookmarks

접을 수 있는 그룹이 있는 브라우저 스타일 북마크를 관리합니다. 북마크가 추가되면 서버가 자동으로 페이지 메타데이터 (제목)를 가져옵니다.

타입 정의

bash
type Bookmark {
  id: ID!
  url: String!
  title: String!              # auto-fetched from <title> when available
  groupId: ID!
  pinned: Boolean!
  sortOrder: Int!
  updatedAt: String!
}

type BookmarkGroup {
  id: ID!
  name: String!
  collapsed: Boolean!
  sortOrder: Int!
}

input BookmarkInput {
  url: String
  title: String
  groupId: String
  pinned: Boolean
  sortOrder: Int
}

작업

query

bookmarks

모든 북마크를 나열합니다.

bash
query GetBookmarks {
  bookmarks { id url title groupId pinned sortOrder updatedAt }
}
query

bookmarkGroups

모든 북마크 그룹을 나열합니다.

bash
query GetBookmarkGroups {
  bookmarkGroups { id name collapsed sortOrder }
}
mutation

addBookmarks

그룹에 하나 이상의 북마크를 추가합니다. 서버는 제목을 채우기 위해 북마크마다 메타데이터 가져오기 이벤트를 발생시킵니다.

bash
mutation AddBookmarks($urls: [String!]!, $groupId: String!) {
  addBookmarks(urls: $urls, groupId: $groupId) { id url title groupId pinned sortOrder updatedAt }
}
mutation

updateBookmark

기존 북마크의 하나 이상의 필드를 업데이트합니다.

bash
mutation UpdateBookmark($id: ID!, $input: BookmarkInput!) {
  updateBookmark(id: $id, input: $input) { id url title groupId pinned sortOrder updatedAt }
}
mutation

deleteBookmarks

ID로 하나 이상의 북마크를 삭제합니다.

bash
mutation DeleteBookmarks($ids: [ID!]!) {
  deleteBookmarks(ids: $ids)
}
mutation

recordBookmarkClick

북마크 클릭을 기록합니다 (분석 / "가장 많이 방문한" 정렬에 사용).

bash
mutation RecordBookmarkClick($id: ID!) {
  recordBookmarkClick(id: $id)
}
mutation

createBookmarkGroup

새 북마크 그룹을 만듭니다.

bash
mutation CreateBookmarkGroup($name: String!) {
  createBookmarkGroup(name: $name) { id name collapsed sortOrder }
}
mutation

updateBookmarkGroup

북마크 그룹의 이름, 접기 상태 또는 정렬 순서를 업데이트합니다.

bash
mutation UpdateBookmarkGroup($id: ID!, $name: String!, $collapsed: Boolean!, $sortOrder: Int!) {
  updateBookmarkGroup(id: $id, name: $name, collapsed: $collapsed, sortOrder: $sortOrder) {
    id name collapsed sortOrder
  }
}
mutation

deleteBookmarkGroup

북마크 그룹을 삭제합니다. 내부의 북마크는 삭제되지 않고 그룹 해제만 됩니다.

bash
mutation DeleteBookmarkGroup($id: ID!) {
  deleteBookmarkGroup(id: $id)
}