Categories

A query de categories retorna informações de categorias cadastradas na loja.

Requisição

Parâmetros

ParâmetroTipoObrigatórioDescrição
Parâmetros de paginaçãoSimParâmetros utilizados na paginação por cursor
categoryIds[Long]NãoFiltro de categorias por IDs
sortDirectionEnum SortDirectionNãoDireção de ordenação. Por padrão é ASC
sortKeyEnum CategorySortKeysNãoChave de ordenação. Por padrão é ID

Campos

CampoDescrição
categoryIdID de cadastro da categoria
childrenLista de categorias filhas
descriptionDescrição da categoria
displayMenuSe a categoria deve ser exibida no menu do site
hotsiteAliasAlias do hotsite da categoria
hotsiteUrlURL do hotsite da categoria
imageUrlURL da imagem associada à categoria
imageUrlLinkLink de acesso à imagem da categoria
nameNome da categoria
parentCategoria pai, se existente
parentCategoryIdID da categoria pai
positionOrdem na qual a categoria será exibida
productsLista de produtos pertencentes à categoria. São paginados por cursor
urlLinkURL relacionada à categoria

Exemplo

Neste exemplo são pedidas informações das 2 primeiras categorias da loja:

query {
  categories(first:2) {
    edges {
      cursor
      node {
        categoryId
        name
      }
    }
  }
}
Mostrar resposta
{
  "data": {
    "categories": {
      "edges": [
        {
          "cursor": "eyJJZCI6MSwiVmFsdWUiOiIxIn0=",
          "node": {
            "categoryId": 1,
            "name": "TIPOS CABELOS"
          }
        },
        {
          "cursor": "eyJJZCI6MiwiVmFsdWUiOiIyIn0=",
          "node": {
            "categoryId": 2,
            "name": "TINTURA E COLORAÇÃO"
          }
        }
      ]
    }
  }
}

Novo filtro URLs para obter a categoria

Abaixo temos um exemplo, que será possível obter a categoria a partir da URL consultada:

query {
  categories(urls: "country/haras-e-fazenda", first: 50) {
    nodes {
      categoryId
      name
      hotsiteUrl
      children {
        categoryId
        name
        hotsiteUrl
      }
    }
  }
}
Mostrar resposta
{
  "data": {
    "categories": {
      "nodes": [
        {
          "categoryId": 68,
          "name": "Haras e Fazenda",
          "hotsiteUrl": "country/haras-e-fazenda",
          "children": [
            {
              "categoryId": 80,
              "name": "Capas e Outros",
              "hotsiteUrl": "country/haras-e-fazenda/capas-e-outros"
            }
          ]
        }
      ]
    }
  }
}