Como utilizar palavras-chave para obter dados da API do BuscaPé – Parte 03

Para facilitar a procura por produtos, a API do BuscaPé nos permite
utilizar palavras-chave em vários de seus serviços. Nos artigos
anteriores da série, vimos como utilizá-las através dos serviços Find Category List e Find Product List.

Dando continuidade à nossa série, chegamos hoje ao último serviço: o Find Offer List, que nos permite a filtragem de resultados por palavras-chave em uma requisição para obter dados da API do BuscaPé.

Veja os artigos anteriores:

• Como utilizar palavras-chave para obter dados da API do BuscaPé – Parte 02
• Como utilizar palavras-chave para obter dados da API do BuscaPé – Parte 01

Find Offer List

O serviço Find Offer List nos permite obter todas as
ofertas de um determinado produto cadastrado 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 Offer List:

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

Como obter os dados?

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

http://sandbox.buscape.com/service/findOfferList//?keyword=keyword

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

http://sandbox.buscape.com/service/findOfferList//?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 Offer List para nos retornar uma lista de ofertas que contenham as palavras-chave notebook e Sony.

http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?keyword=notebook+sony

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/findOfferList/564771466d477a4458664d3d/?keyword=notebook+sony&format=json 

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

Combinando palavras-chave com o ID de uma categoria final

O serviço Find Offer List nos permite 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 6424 com as palavras-chave notebook e Sony.

http://sandbox.buscape.com/service/findOfferList/564771466d477a4458664d3d/?categoryId=6424&keyword=notebook+sony

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

Chegamos assim ao final da série Como utilizar palavras-chave para obter dados da API do BuscaPé.
Aprendemos nos três artigos da série como obter listas de categorias,
produtos e ofertas através de palavras-chave utilizando os serviços Find Category List, Find Product List e Find Offer List, respectivamente.

Fique de olho na nossa seção de tutoriais e acompanhe os próximos
artigos e os vídeos que iremos disponibilizar em breve. Toda semana temos
um novo artigo abordando a utilização da API do BuscaPé em nossas
aplicações.

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