Para facilitar a procura por produtos, a API do BuscaPé nos permite
utilizar palavras-chave em vários de seus serviços. No primeiro artigo
da série, vimos como utilizá-las através do serviço Find Category List.

Dando continuidade à nossa série de 3 (três) artigos, abordaremos o uso do serviço Find Product List, o segundo que nos permite a filtragem de resultados por palavras-chave em uma requisição para obter dados da API do BuscaPé.

Find Product List

O serviço Find Product List nos permite obter dados
dos produtos cadastrados na API do BuscaPé. Podemos recuperá-los
utilizando apenas palavras-chave ou combinando-as com o ID de uma
categoria final.

Como o serviço funciona?

A imagem abaixo traz uma representação de como funciona o serviço Find Product List:

A aplicação efetua uma requisição, neste caso, informando as palavras-chave. O serviço Find Product List a recebe, realiza a procura pela lista de produtos e retorna os resultados à aplicação no formato especificado.

Como obter os dados?

Abaixo, temos a URL padrão para obter uma lista de produtos da API do BuscaPé. Nela devemos informar o código da nossa aplicação, bem como as palavras-chave pelas quais desejamos pesquisar.

http://sandbox.buscape.com/service/findProductList/application_id/?keyword=keyword

O serviço Find Product List nos permite, facultativamente, informar como parâmetro o ID de uma categoria final junto às palavras-chave.

http://sandbox.buscape.com/service/findProductList/application_id/?categoryId=categoryId&keyword=keyword

Em ambos os casos, os dados podem ser retornados em XML e JSON, sendo o primeiro o formato padrão adotado pela API do BuscaPé.

– XML

Vamos agora utilizar o serviço Find Product List para nos retornar uma lista de produtos que contenham as palavras-chave celular e Nokia.

http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?keyword=celular+nokia

Clique aqui para visualizar o código (arquivo .txt)

– JSON

Assim como nos outros serviços da API do BuscaPé, para retornar os dados em JSON, apenas adicionaremos, ao final da URL, o parâmetro format=json.

http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?keyword=celular+nokia&format=json

Clique aqui para visualizar o código (arquivo .txt)

Combinando palavras-chave com o ID de uma categoria

Eventualmente, podemos combinar palavras-chave e o ID de uma categoria
final para obter um resultado mais refinado na busca. Para isso,
devemos utilizar o parâmetro categoryId, como podemos
ver no exemplo a seguir, em que recuperamos uma lista de produtos
existentes na categoria final de ID 77 com as palavras-chave celular e
Nokia.

http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/?categoryId=77&keyword=celular+nokia

Clique aqui para visualizar o código (arquivo .txt)

Você aprendeu, neste segundo artigo da série, como obter uma lista de produtos por meio de palavras-chave, utilizando o serviço Find Product List da API do BuscaPé. Fique de olho na nossa seção de tutoriais e acompanhe os próximos artigos da série Como utilizar palavras-chave para obter dados da API do BuscaPé.

Deixe abaixo seu comentário e participe do nosso Fórum de Discussão.