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
comsearchId
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.
- Posso utilizar a secretKey na URL quando fizer a chamada no frontend?
- Posso priorizar a implementação de algumas features, e deixar outras para depois?
- Posso criar uma camada de cache com as requisições que são feitas à API de Busca?
- Como eu faço para esconder um filtro?
- Não estou recebendo no retorno da API todos os filtros que eu preciso, o que fazer?