Dúvidas Frequentes (FAQ)

Posso utilizar a secretKey na URL quando fizer a chamada no frontend?

Não. A secretKey é a sua chave de autenticação, se utilizar ela nas requests expostas pelo frontend você estará comprometendo a segurança dos seus dados. A forma correta é com a autenticação via domínio, como explicado na introdução.

Posso priorizar a implementação de algumas features, e deixar outras para depois?

Sim. Para ter uma Busca minimamente funcional não é necessária a implementação de todas as features e endpoints desta documentação.

Para te auxiliar na priorização, criamos o Guia de Implementação, explicando um pouco sobre cada módulo. Só não esqueça de implementar o tracking de clicks, ok? ;)

O tamanho do escopo inicial vai depender muito da necessidade do seu time de negócios, em caso de dúvidas consulte seu Gerente de Projetos de Integração. E claro, para extrair o maior valor possível da solução, recomendamos a implementação de todos os módulos.

Posso criar uma camada de cache com as requisições que são feitas à API de Busca?

Sim, porém tenha muita atenção aos seguintes pontos:

• É obrigatório manter o tagueamento linxMeta com searchId e a coleta de interações via /clicks
• As informações de produtos podem, eventualmente, ficar desatualizadas para seus usuários
• Caso o deviceId seja enviado na request, a requisição não pode ser cacheada pois perderá a personalização.

Como eu faço para esconder um filtro?

Se você está recebendo um filtro indesejado no retorno da API é necessário que você informe o seu Gerente de Projetos de Integração, ou seu Gerente de Contas para que façamos o blocklist do atributo via backend.

Por padrão, são gerados filtros a partir de qualquer atributo de produto, por exemplo, categoria, voltagem, tamanho, cor, sabor, preço, desconto, etc..

Não estou recebendo no retorno da API todos os filtros que eu preciso, o que fazer?

Existem ao menos três causas para o problema apontado:

• Este atributo não existe no catálogo:
  Você já verificou se os produtos da listagem possuem este atributo no catálogo? Para validar utilize o Data-Check. Caso não encontre o determinado atributo lá, verifique com seu time de TI se os atributos estão sendo definidos na sua forma de atualização de catálogo, como explicamos aqui Catálogo de Produtos.
• O atributo foi bloqueado no backend de Busca:
  Fazemos isso via configuração, na dúvida consulte o seu Gerente de Contas ou Gerente de Projetos de Integração.
• Os produtos possuem muitos outros atributos:
  Nós retornaremos apenas os filtros mais relevantes, ou seja os mais utilizados, até um certo limite de X filtros. Este valor é configurável, assim como também podemos dar maior peso de ponderação para este filtros se você considera importante. Desta forma ele irá ter um incremento de relevância, e aparecerá para os seus usuários. Entre em contato com seu Gerente de Projetos de Integração.