[Resolvido] Utilizando os filtros de ofertas com o Wrapper .NET d

[RSS iMasters 5]

Utilizaremos a nova funcionalidade do Wrapper .NET para filtrar os resultados da busca de ofertas.

Para facilitar a vida dos desenvolvedores, o BuscaPé mantém vários Wrappers para sua API que você pode encontrar facilmente no perfil BuscaPéDev no GitHub. Um desses wrappers é o wrapper .NET que vamos utilizar neste tutorial. Então, faça o download desse wrapper.

Efetuado o download do Wrapper .NET, adicione o arquivo da classe ao seu projeto, ou se preferir, apenas adicione uma referência à biblioteca compilada da classe (.dll) que também está disponível para download.

Com tudo pronto, mãos na massa.

O método FindOfferList do Wrapper .Net foi remodelado a fim de atender com mais fidelidade a essa função da API do BuscaPé. Foram implementados os filtros disponíveis na API do BuscaPé e deixamos mais ?clean? a forma de repassar esses parâmetros para a função.

Inicialmente, 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");

Para termos os filtros de uma forma mais limpa e intuitiva, criamos uma nova classe chamada FiltrosFindOfferList que nos proverá todos os filtros disponíveis na função findOfferList da API do BuscaPé. Assim também facilitaremos a manutenção dessa função caso algum filtro seja adicionado ou retirado futuramente, evitando que novas sobrecargas do método tenham que ser criadas.

Portanto, antes de utilizar o método FindOfferList, devemos instanciar um objeto do tipo FiltrosFindOfferList.

FiltrosFindOfferList filtros = new FiltrosFindOfferList();

Agora utilizaremos as propriedades desse novo objeto para dizer ao método quais filtros iremos utilizar na busca das ofertas. Após atribuir um valor para cada filtro desejado, invocamos a nova sobrecarga do método FindOfferList, informando o objeto com os filtros selecionados.

filtros.Keyword = "TV+LG";

filtros.Sort = "price";

filtros.Medal = "diamond";

filtros.Results = 5;

string return = apiBuscape.FindOfferList(filtros);

O retorno do método continua o mesmo, uma string com o XML retornado pela API do BuscaPé. Para os filtros que configuramos acima, obtivemos o retorno abaixo.

<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" page="1" totalPages="29" totalResultsSellers="10" totalResultsReturned="5" totalResultsAvailable="141" 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>2011-08-23T10:55:51.028-03:00</date>

<elapsedTime>33</elapsedTime>

 

<status>success</status>

<code>0</code>

<message>success</message>

</details>

<category hasOffer="false" isFinal="true" parentCategoryId="1" id="2852">

<thumbnail url="http://imagem.buscape.com.br/bp5/categorias/2852.jpg"/>

<links>

 

<link type="category" url="http://compare.buscape.com.br/tv.html?mdapp=100&mddtn=69672797"/>

<link type="xml" url="http://sandbox.buscape.com/service/findProductList/564771466d477a4458664d3d/br/?categoryId=2852&keyword=tv+lg"/>

</links>

<name>TV</name>

</category>

<offer productId="257452" id="78585088" categoryId="2852">

<offerName>Televisor Led 32 ´ Lg 32le5500, Full Hd, 2 Conexões Usb Divx, Wireless Av Link, Conversor Digital - Cod: 3054696</offerName>

<links>

 

<link type="offer" url="http://tracker.lomadee.com/tr/rd?b=OT8RE2VmGA4IGGsOZ2YoCwgrExYGKDAWLyAfc3NlZ2xobGtqamVvbm5laGdoaWxpZ2llNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3OitjbGtpamtseDM6OiowY2hnaGlsaWdpeDM6Py4uY29ubmUwMSw7OGVvZRwMZWVlbmVuZW5lbmVuZW5lbmVpZmtma25mZmVucG5lbnBuZW9lZW5l"/>

</links>

<thumbnail url="http://thumbnails.buscape.com.br/offerimg/l/i/livrariasaraiva/3d2/31f/100x100_46878dimagem%23L%253D500%2526A%253D%252D1%2526pro_id%253D3054696.jpg"/>

<price>

<currency abbreviation="BRL"/>

<value>1549.00</value>

<parcel>

<value>129.08</value>

 

<number>12</number>

<interest>0.0</interest>

</parcel>

</price>

<seller pagamentoDigital="false" isTrustedStore="true" id="155">

<sellerName>Saraiva.com.br</sellerName>

<thumbnail url="http://imagem.buscape.com.br/vitrine/logo155.gif"/>

 

<links>

<link type="seller" url="http://www.livrariasaraiva.com.br/?PAC_ID=25371"/>

</links>

<contacts>

<contact label="SAC" value="11-39334000"/>

<contact label="Televendas" value="4003-3390"/>

</contacts>

<rating>

<userAverageRating>

 

<numComments>135101</numComments>

<rating>8.0</rating>

</userAverageRating>

<eBitRating>

<numComments>135101</numComments>

<rating>diamante</rating>

</eBitRating>

 

</rating>

</seller>

</offer>

<offer productId="116957" id="75313397" categoryId="2852">

<offerName>TV 21 ´ Tela Plana LG Flat 21FJ6RB - cod. 1527</offerName>

<links>

<link type="offer" url="http://tracker.lomadee.com/tr/rd?b=GygxMGUNCQYqMj08ay0SBysUFwwSMA0nC2s5c3NlZ2xobGtqamVvbm5laGdoaWxpZ2llNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3Oitjb29oZ2tpeDM6OiowY2hnaGlsaWdpeDM6Py4uY29ubmUwMSw7OGVvZRwMZWVlbmVuZW5lbmVuZW5lbmVpa21vbW1naWVucG5lbnBuZW9lZW5l"/>

</links>

 

<thumbnail url="http://thumbnails.buscape.com.br/offerimg/p/o/pontofrio/570/a42/100x100_07a673ArquivoExibir%23IdArquivo%253D14612.jpg"/>

<price>

<currency abbreviation="BRL"/>

<value>341.05</value>

</price>

<seller pagamentoDigital="false" isTrustedStore="true" id="114286">

<sellerName>PontoFrio.com</sellerName>

<thumbnail url="http://imagem.buscape.com.br/vitrine/logo114286.gif"/>

 

<links>

<link type="seller" url="http://www.pontofrio.com.br/?utm_source=buscape&utm_medium=comparadorpreco&utm_campaign=BuscaPontoFrio"/>

</links>

<contacts>

<contact label="SAC" value="4002-3388"/>

<contact label="Televendas" value="4002-3050"/>

</contacts>

<rating>

<userAverageRating>

 

<numComments>108639</numComments>

<rating>7.0</rating>

</userAverageRating>

<eBitRating>

<numComments>108639</numComments>

<rating>diamante</rating>

</eBitRating>

 

</rating>

<coupon id="26529">

<link type="coupon" url="http://preco.buscape.com.br/cupom/cupom.asp?lkpm=26529&id_prod=75313397&id_emp=114286"/>

<description>desconto de 5.00%</description>

<type>desc</type>

</coupon>

</seller>

</offer>

 

<offer productId="324852" id="94582568" categoryId="2852">

<offerName>TV LED LCD LG Cinema 3D com 42 ´ Full HD, Conversor Digital, Conversor de 2D para 3D, 120Hz, Internet - cod. 10846</offerName>

<links>

<link type="offer" url="http://tracker.lomadee.com/tr/rd?b=LCYzGWULPGtvbjMuDS05b2wvORMqASkGFCopc3NlZ2xobGtqamVvbm5laGdoaWxpZ2llNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3OitjbWxqZmtseDM6OiowY2hnaGlsaWdpeDM6Py4uY29ubmUwMSw7OGVvZRwMZWVlbmVuZW5lbmVuZW5lbmVnamtmbGtoZmVucG5lbnBuZW9lZW5l"/>

</links>

<thumbnail url="http://thumbnails.buscape.com.br/offerimg/f/a/fastshop/624/83c/100x100_1958ceLGCJ42W57_CONT_n.jpg"/>

<price>

<currency abbreviation="BRL"/>

 

<value>3324.40</value>

<parcel>

<value>369.90</value>

<number>10</number>

<interest>1.99</interest>

</parcel>

</price>

 

<seller pagamentoDigital="false" isTrustedStore="true" id="1261">

<sellerName>Fast Shop.com.br</sellerName>

<thumbnail url="http://imagem.buscape.com.br/vitrine/logo1261.gif"/>

<links>

<link type="seller" url="http://www.fastshop.com.br/default.aspx?par=bpvitrine"/>

</links>

<contacts>

<contact label="SAC" value="11-32323200"/>

 

<contact label="Televendas" value="11-32323100"/>

</contacts>

<rating>

<userAverageRating>

<numComments>27065</numComments>

<rating>8.0</rating>

</userAverageRating>

<eBitRating>

 

<numComments>27065</numComments>

<rating>diamante</rating>

</eBitRating>

</rating>

</seller>

</offer>

<offer productId="257452" id="79204161" categoryId="2852">

<offerName>LG 32LE5500 LED 32 FULL HD cod. 0000056687781</offerName>

 

<links>

<link type="offer" url="http://tracker.lomadee.com/tr/rd?b=H2cfJmVobxkcNzMPOR0NARYMaxEqEjEcB24fc3NlZ2xobGtqamVvbm5laGdoaWxpZ2llNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3OitjbGtpamtseDM6OiowY2hnaGlsaWdpeDM6Py4uY29ubmUwMSw7OGVvZRwMZWVlbmVuZW5lbmVuZW5lbmVpZ2xuam9ob2VucG5lbnBuZW9lZW5l"/>

</links>

<thumbnail url="http://thumbnails.buscape.com.br/offerimg/f/n/fnac/146/a0e/100x100_5527fb550321_0_5.jpg"/>

<price>

<currency abbreviation="BRL"/>

<value>1499.00</value>

<parcel>

 

<value>149.90</value>

<number>10</number>

<interest>0.0</interest>

</parcel>

</price>

<seller pagamentoDigital="false" isTrustedStore="true" id="370">

<sellerName>Fnac.com.br</sellerName>

 

<thumbnail url="http://imagem.buscape.com.br/vitrine/logo370.gif"/>

<links>

<link type="seller" url="http://www.fnac.com.br"/>

</links>

<contacts>

<contact label="SAC" value="11-30385599"/>

</contacts>

<rating>

<userAverageRating>

 

<numComments>12498</numComments>

<rating>7.0</rating>

</userAverageRating>

<eBitRating>

<numComments>12498</numComments>

<rating>diamante</rating>

</eBitRating>

 

</rating>

</seller>

</offer>

<offer productId="257452" id="78829914" categoryId="2852">

<offerName>Televisor Led 32 ´ Lg 32le5500, Full Hd, 2 Conexões Usb Divx, Wireless Av Link, Conversor Digital - Cod: 3054696</offerName>

<links>

<link type="offer" url="http://tracker.lomadee.com/tr/rd?b=Ch1vHWVtHTsOHS8yJzggbGYbBDokMRsxKDk5c3NlZ2xobGtqamVvbm5laGdoaWxpZ2llNioqLmRxcT0xMy4_LDtwPCstPT8uO3A9MTNwPCxxLiwxOgErMDc9MWE3OitjbGtpamtseDM6OiowY2hnaGlsaWdpeDM6Py4uY29ubmUwMSw7OGVvZRwMZWVlbmVuZW5lbmVuZW5lbmVpZmZsZ2dvamVucG5lbnBuZW9lZW5l"/>

</links>

 

<thumbnail url="http://thumbnails.buscape.com.br/offerimg/s/i/siciliano/69e/c86/100x100_013f03imagem%23L%253D500%2526A%253D%252D1%2526pro_id%253D3054696.jpg"/>

<price>

<currency abbreviation="BRL"/>

<value>1549.00</value>

<parcel>

<value>129.08</value>

<number>12</number>

 

<interest>0.0</interest>

</parcel>

</price>

<seller pagamentoDigital="false" isTrustedStore="true" id="157">

<sellerName>Siciliano</sellerName>

<thumbnail url="http://imagem.buscape.com.br/vitrine/logo157.gif"/>

<links>

<link type="seller" url="http://www.siciliano.com.br/default.asp?parc=BULL"/>

 

</links>

<contacts>

<contact label="SAC" value="11-39334020"/>

<contact label="Televendas" value="03007893649"/>

<contact label="Televendas" value="11-36494747"/>

</contacts>

<rating>

<userAverageRating>

<numComments>8393</numComments>

 

<rating>7.0</rating>

</userAverageRating>

<eBitRating>

<numComments>8393</numComments>

<rating>diamante</rating>

</eBitRating>

</rating>

 

</seller>

</offer>

</Result>

Você desenvolvedor que já tem o método FindOfferList implementado da forma antiga, não se preocupe. Não fizemos alteração nessa maneira de recuperar as ofertas, apenas criamos uma nova sobrecarga do método. Porém, caso você queira utilizar todos os filtros disponibilizados pela API do BuscaPé, você terá que utilizar o novo formato do método.

Para saber mais sobre os filtros disponibilizados pela API do BuscaPé para a lista de ofertas, consulte nossa documentação.

Caso tenha ficado alguma dúvida na implementação do método, deixe seu comentário e participe do nosso Fórum.

 

http://imasters.com.br/artigo/22201/apis-buscape/utilizando-os-filtros-de-ofertas-com-o-wrapper-net-do-buscape-developer