Dấu trang
Kiểm tra app.capabilities để biết tính năng và app.access cùng quyền máy chủ để xác định quyền truy cập. Thay giá trị mẫu trước khi gọi.
Định nghĩa kiểu
type Mutation {
addBookmarks(urls: [String!]!, groupId: ID!): [Bookmark!]!
createBookmarkGroup(name: String!): BookmarkGroup!
deleteBookmarkGroup(id: ID!): Boolean!
deleteBookmarks(ids: [ID!]!): ActionResult!
importBookmarks(content: String!): ActionResult!
recordBookmarkClick(id: ID!): Boolean!
updateBookmark(id: ID!, input: BookmarkInput!): Bookmark!
updateBookmarkGroup(id: ID!, name: String!, collapsed: Boolean!, sortOrder: Int!): BookmarkGroup!
}
type Query {
bookmark(id: ID!): Bookmark
bookmarkGroups: [BookmarkGroup!]!
bookmarks: [Bookmark!]!
pageMetadata(url: String!): PageMetadata!
}
type Subscription {
bookmarksUpdated: [Bookmark!]!
}
type ActionResult {
affectedCount: Int!
}
type Bookmark {
id: ID!
url: String!
title: String!
faviconPath: String!
groupId: ID!
pinned: Boolean!
clickCount: Int!
sortOrder: Int!
createdAt: Instant!
updatedAt: Instant!
lastClickedAt: Instant
}
type BookmarkGroup {
id: ID!
name: String!
collapsed: Boolean!
sortOrder: Int!
itemCount: Int!
createdAt: Instant!
updatedAt: Instant!
}
input BookmarkInput {
url: String!
title: String!
faviconUrl: String
groupId: ID!
pinned: Boolean!
sortOrder: Int!
}
scalar Instant
type PageMetadata {
title: String
faviconUrl: String
}Thao tác
addBookmarks
Tạo dấu trang cho các URL được cung cấp trong nhóm đã chỉ định.
mutation addBookmarks($urls: [String!]!, $groupId: ID!) {
addBookmarks(urls: $urls, groupId: $groupId) { id url title faviconPath groupId pinned clickCount sortOrder }
}createBookmarkGroup
Tạo nhóm dấu trang mới.
mutation createBookmarkGroup($name: String!) {
createBookmarkGroup(name: $name) { id name collapsed sortOrder itemCount createdAt updatedAt }
}deleteBookmarkGroup
Xóa nhóm dấu trang. Dấu trang bên trong không bị xóa, chỉ được bỏ khỏi nhóm.
mutation deleteBookmarkGroup($id: ID!) {
deleteBookmarkGroup(id: $id)
}deleteBookmarks
Xóa một hoặc nhiều dấu trang theo ID.
mutation deleteBookmarks($ids: [ID!]!) {
deleteBookmarks(ids: $ids) { affectedCount }
}importBookmarks
Nhập dấu trang từ nội dung tài liệu được cung cấp và báo số bị tác động.
mutation importBookmarks($content: String!) {
importBookmarks(content: $content) { affectedCount }
}recordBookmarkClick
Tăng số lượt truy cập đã lưu của dấu trang.
mutation recordBookmarkClick($id: ID!) {
recordBookmarkClick(id: $id)
}updateBookmark
Cập nhật một hoặc nhiều trường của dấu trang hiện có.
mutation updateBookmark($id: ID!, $input: BookmarkInput!) {
updateBookmark(id: $id, input: $input) { id url title faviconPath groupId pinned clickCount sortOrder }
}updateBookmarkGroup
Cập nhật tên, trạng thái thu gọn hoặc thứ tự sắp xếp nhóm dấu trang.
mutation updateBookmarkGroup($id: ID!, $name: String!, $collapsed: Boolean!, $sortOrder: Int!) {
updateBookmarkGroup(id: $id, name: $name, collapsed: $collapsed, sortOrder: $sortOrder) { id name collapsed sortOrder itemCount createdAt updatedAt }
}bookmark
Đọc một dấu trang đã lưu theo ID; trả về null nếu không có.
query bookmark($id: ID!) {
bookmark(id: $id) { id url title faviconPath groupId pinned clickCount sortOrder }
}bookmarkGroups
Liệt kê mọi nhóm dấu trang.
query bookmarkGroups {
bookmarkGroups { id name collapsed sortOrder itemCount createdAt updatedAt }
}bookmarks
Liệt kê mọi dấu trang.
query bookmarks {
bookmarks { id url title faviconPath groupId pinned clickCount sortOrder }
}pageMetadata
Lấy tiêu đề và URL favicon của trang web mà không lưu dấu trang.
query pageMetadata($url: String!) {
pageMetadata(url: $url) { title faviconUrl }
}bookmarksUpdated
Nhận bản ghi dấu trang đã cập nhật.
subscription bookmarksUpdated {
bookmarksUpdated { id url title faviconPath groupId pinned clickCount sortOrder }
}