# Listas

O sistema foi implementado por controle de listas e é através delas que você pode carregar produtos, etiquetas, fabricas....

# Lista de produtos

get /listas/produtos

Retorna a lista de produtos conforme os filtros, ordenação e paginação.

# Requisição

Parâmetros query:

query descrição
q Texto de busca para filtrar os produtos
p Qual o indice da página
qtd Qtdade de produtos por página. Padrão 20
ordem Qual a classificação de ordenação. menor_preco, maior_preco, ofertas, lancamentos, mais_vendidos, mais_populares
filtros Lista de filtro pré-definidos
marcas Lista de etiquetas (slug)
departamentos Lista de departamentos (slug)
header descrição
sessao_id Token da sessao do usuário no front-end. Para ser usando na lista de histórico de navegação por exemplo

As listas, de marcas, departamentos, filtros, pode ser informado um único item ou uma lista separada por vírgula.

auth
Quando executado sobre um access_token, alguns filtros do usuário logado são aplicados.

# Pré filtros

A busca no sistema por produtos, pode ser realizada através de filtros de produtos pré-definidas. Abaixo temos os filtros padrões que já estão disponíveis:

  • lancamentos - Lista de produtos para exibir os produtos rescém lançados na loja.
  • ofertas - Lista de produtos que estão com promoções/ofertas ativas.
  • historico_navegacao - Lista de produtos do usuário ou sessao_id referênte a navegação pelos últimos produtos.
  • favoritos - Lista de produtos marcados como favoritos para o usuário logado. Informar sessao_id.

# Resposta

atributo descrição
title Objeto com o title e parâmetros conforme a busca.
count Quantidade de produtos encontrado com base no filtro sem paginação
produtos Lista de produtos encontrado. Ver produto

# Exemplo de resposta:

{
    "title": {
        "id": "busca",
        "data": {
            "q": "regata"
        }
    },
    "count": 10,
    "produtos": [
        //....
    ]
}

# Lista de etiquetas/marcas

get /listas/etiquetas

Retorna a lista de etiquetas/marcas das fábricas com produtos ativos na loja.

# Requisição

Nenhum parâmetro precisa ser passado

# Resposta

Lista de etiquetas

atributo descrição
id ID da etiqueta
nome Nome descritivo da etiqueta
slug Slug para ser utilizado nas rotas
logos Sub objeto
logos.fabrica URI da logo da fábrica
logos.etiqueta URI da logo da etiqueta específica

# Lista de departamentos

get /listas/departamentos

Retorna a lista de departamentos ativos na loja.

# Requisição

Parâmetros query:

query descrição
subitens Flag que determina se deve exibir os sub-departamentos (Padrão: false)

# Resposta

Lista de departamentos

atributo descrição
id ID do departamento
nome Nome descritivo do departamento
slug Slug para ser utilizado nas rotas
logo URI da logo do departamento
subitens Lista de sub-departamentos