Marcadores

Referencia de la API

Gestiona marcadores estilo navegador con grupos plegables. El servidor obtiene automáticamente los metadatos de la página (título) cuando se añade un marcador.

Definiciones de tipos

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
}

Operaciones

query

bookmarks

Lista todos los marcadores.

bash

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

query

bookmarkGroups

Lista todos los grupos de marcadores.

bash

query GetBookmarkGroups {
  bookmarkGroups { id name collapsed sortOrder }
}

mutation

addBookmarks

Añade uno o más marcadores a un grupo. El servidor dispara un evento de obtención de metadatos por marcador para rellenar el título.

bash

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

mutation

updateBookmark

Actualiza uno o más campos de un marcador existente.

bash

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

mutation

deleteBookmarks

Elimina uno o más marcadores por ID.

bash

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

mutation

recordBookmarkClick

Registra un clic en un marcador (usado para la analítica / ordenación "más visitados").

bash

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

mutation

createBookmarkGroup

Crea un grupo de marcadores nuevo.

bash

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

mutation

updateBookmarkGroup

Actualiza el nombre, estado plegado u orden de un grupo de marcadores.

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

Elimina un grupo de marcadores. Los marcadores dentro no se eliminan, solo se quitan del grupo.

bash

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