Funcionamento

Storefront SSR

Storefront local

Query Strings

Tipos

Query stringTipoDescrição
buscastringUtilizado na página de busca para especificar o termo a ser buscado.
paginaintegerUtilizado em paginações para especificar a página a ser buscada. Caso não seja informada, será considerado o valor padrão de 1.
cursorstringUtilizado em paginações para especificar a partir de qual cursor deve ser buscado.
tamanhointegerUtilizado em paginações para especificar a quantidade de resultados a serem buscados.
Para páginas de busca é possível definir um valor padrão no arquivo Configs/settings.json, com a estrutura:
"page_size":{ "default": 24 }
Essa configuração não é obrigatória, portanto, caso não haja configuração e não seja informado o tamanho por query string, será considerado o valor de 24.
Para páginas de hotsite, caso não seja informado um tamanho, será considerado o valor padrão de cadastro do hotsite.
filtrostring[]Utilizado para filtrar de acordo com os filtros da página. Deve ser utilizado com filtro__valor.
ordenacaostringUtilizado em paginações para especificar a ordenação dos resultados. Deve ser utilizado da com ChaveOrdenação:DireçãoOrdenação.
Caso não seja informado, será considerado o valor padrão NAME;ASC.
precoPorstringUtilizado em paginações para filtrar os resultados por preço. Deve ser utilizado com preçoMinimo;preçoMaximo.

Exemplos

busca

busca=tenis

pagina

pagina=2

cursor

cursor=f6c16acebb694816b8

tamanho

tamanho=12

filtro

Filtro Cor de valor azul

filtro=Cor__azul

Filtro Jaquetas e Coletes de valor Jaqueta Impermeável

filtro=Jaquetas+e+Coletes__Jaqueta+Impermeável

ordenacao

Ordenação por menor preço

ordenacao=PRICE;ASC

Ordenação por lançamentos

ordenacao=RELEASE_DATE;DESC

precoPor

Preços de 2000 até 3000

precoPor=2000.0;3000.0

Preço mínimo de 10000

precoPor=10000.0;*

Query Strings na API

As query strings apresentadas podem ser utilizadas diretamentes nas queries do Storefront API. Cada uma representa a seguinte variável presente nos arquivos de query:

Query stringArgumento na API
buscasearchQuery
tamanhoresultSize
cursorafter
ordenacaosortKey = ChaveOrdenação
sortDirection = DireçãoOrdenação
filtrofilters
precoPorminimumPrice = preçoMinimo
maximumPrice = preçoMaximo

Diferentes tipos de páginas

📘

Nota

As páginas de hotsite podem utilizar todas as query strings descritas anteriormente, exceto "busca", pois ela é exclusiva para páginas de busca. As páginas de busca podem utilizar todas as query strings descritas anteriormente.