Utilizando os filtros de ofertas com o Wrapper .NET do BuscaPé Developer
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.
pelo Dev Buscapé Developer desenvolvedores externos podem utilizar o WebService disponível pelo Buscapé para criar suas próprias aplicações. No Githun, acompanhe /devbuscapecompany
