Como recuperar produtos através da sua categoria com o Wrapper .Net

Várias são as formas de obter produtos da API do Buscapé. Hoje vamos focar na listagem por categoria. Antes de iniciar a leitura doartigo, faça o download dos arquivos do Wrapper .Net diretamente do nosso perfil no GitHub. Com os arquivos em mãos, adicione-os ao seu projeto no Visual Studio, ou se preferir, faça uma referência à .dll, que também está disponível para download.

Com os arquivos do Wrapper .Net devidamente inseridos no projeto, vamos instanciar um objeto da classe Apiki_Buscapé_API, informando nosso AplicationId:

Apiki_Buscape_API.Apiki_Buscape_API apiBuscape = new Apiki_Buscape_API.Apiki_Buscape_API("564771466d477a4458664d3d");

Existem duas formas de obter uma lista de produtos filtrando pelo ID da categoria, em ambas utilizaremos o método FindProductList.

No primeiro exemplo, vamos utilizar a forma mais simples, que já existe desde a primeira versão do Wrapper. Utilizaremos o método FindProductList apenas informando o ID da categoria:

apiBuscape.FindProductList(9825);

A segunda forma que temos para utilizar o ID da categoria com o método FindProductList é também a maneira mais nova implementada no Wrapper, portanto, se você tem alguma das versões anteriores do Wrapper .Net, essa forma que mostraremos pode não funcionar.

Primeiro, devemos instanciar um novo objeto do tipo FiltrosFindProducts. Depois vamos setar o atributo CategoryId desse objeto com o ID da categoria de que desejamos obter a lista de produtos e, então, invocamos o método FindProductList passando como parâmetro o objeto filtrosProdutos que criamos:

FiltrosFindProducts filtros = new FiltrosFindProducts();
filtrosProdutos.CategoryId = 9825;
string result = apiBuscape.FindProductList(filtrosProdutos);

Para ambos o retorno do método é idêntico: um XML com os produtos da categoria que informamos e com os filtros disponíveis para essa categoria:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" match="all" page="1" totalPages="538" totalResultsReturned="16" totalResultsAvailable="8605" xsi:schemaLocation="http://developer.buscape.com/admin/buscape.xsd">
    <details>
        <applicationID>564771466d477a4458664d3d</applicationID>
        <applicationVersion>1.0.0.0</applicationVersion>
        <applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>
        <date>2012-01-18T10:19:14.073-02:00</date>
        <elapsedTime>2</elapsedTime>
 
       <status>success</status>
        <code>0</code>
        <message>success</message>
    </details>
    <category hasOffer="false" isFinal="true" parentCategoryId="3841" id="9825">
        <thumbnail url="http://imagem.buscape.com.br/bp5/categorias/9825.jpg"/>
        <links>
 
           <link type="category" url="http://compare.buscape.com.br/carros.html?mdapp=100&amp;mddtn=69672797"/>
            <link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=9825"/>
        </links>
        <name>Carros</name>
        <filters>
            </filters>
    </category>
    <product quantity="0" id="144881" eco="false" hasMetaSearch="false" categoryId="9825" totalSellers="2" fullDescription="false">

É isso!