Como obter uma lista de ofertas disponibilizados pelo Buscapé, filtrando pelo ID do produto

Hoje veremos como avançar nos filtros das ofertas disponibilizadas pelo Buscapé. O filtro de hoje se chama “productId”. Usando-o em conjunto com o serviço Find Offer List, da API do Buscapé, você pode obter ofertas específicas de um produto, informando seu ID como parâmetro neste filtro.

No artigo de hoje, usaremos o wrapper PHP para exemplificar e mostrar como podemos utilizá-lo.

Pensando em uma aplicação real, digamos que um cliente use seu aplicativo e busque ofertas relacionadas a “iPhone”. Através dessa pesquisa, podemos ter resultados como iPhone 3GS, 4, 4S, ou até mesmo cases para iPhone. Caso o cliente esteja interessado apenas no iPhone 4S, ele o escolheria e, através do filtro “productId”, nosso aplicativo retornaria apenas as ofertas respectivas a esse produto.

Então, vamos “codar”. Para hoje precisamos baixar e incluir o wrapper PHP desenvolvido pela comunidade e também sabermos um pouco mais sobre como ele é implementado.

Por aqui, criamos um projeto chamado “wrapper-php” e incluimos todo o wrapper PHP baixado. Dentro do wrapper existe uma pasta chamada “example”, e vamos utilizar seu exemplo prático para aplicarmos nosso filtro e vê-lo funcionando. Na imagem abaixo, com a seta indicadora azul, temos o arquivo em que será implementado nosso exemplo. E com a seta verde, temos o arquivo principal do wrapper e a sua classe que deve ser incluída na implementação.

ilter-product-id.php – implementando a busca por ofertas a partir de um ID de um produto:

require_once '../Apiki_Buscape_API.php';
 
$applicationID  = '564771466d477a4458664d3d';
$objBuscaPeApi = new Apiki_Buscape_API( $applicationID );
$objBuscaPeApi->setSandbox();
$offers = $objBuscaPeApi->findOfferList( array( 'productId' => '347015' ) );
echo $offers;

No código acima, nesta ordem fizemos:

• Incluímos a classe do wrapper PHP;
• Definimos o ID da nossa aplicação;
• Instanciamos a nossa classe, passando como parâmetro o ID da aplicação;
• Setamos o ambiente de sandbox do Buscapé;
• Usamos o método findOfferList do wrapper para obter as ofertas em que o ID do produto é o 347015, referente a um iPhone 4S 16GB;
• Exibimos o retorno da API do Buscapé.

Com esse código, conseguimos o seguinte retorno da API do Buscapé:

<details> 564771466d477a4458664d3d
 1.0.0.0
 
http://bws-apps.buscape.com/mobile/update
 
 2012-06-25T11:29:55.749-03:00
 4
 success
 <code>0</code>
 success
 </details>
        Celular e Smartphone
 
        Apple iPhone 4S 16GB GSM Desbloqueado
        Apple iPhone 4S 16GB Desbloqueado
 
        1776.21
        2499.00
 
                15
                8.8
 
                        6.2
 
                        8.8

Como podem perceber, a API do Buscapé nos retorna todas as informações do produto filtrado e todas as ofertas relacionadas a ele.

É isso, developers! Vamos “codar”!