Como obter detalhes de uma loja ou empresa afiliada ao BuscaPé usando o Wrapper .NET

Veremos neste tutorial como utilizar a API do BuscaPé para obter detalhes técnicos de uma loja ou empresa afiliada utilizando seu Wrapper para .NET através do método ViewSellerDetails.

Antes de começar, é necessário realizar o download do Wrapper .NET da API do BuscaPé, que pode ser efetuado aqui ou no link para o Wrapper na nossa seção de documentação.

Como o método funciona?

Ao utilizar o método ViewSellerDetails da classe Apiki_Buscape_API para .NET, é efetuada uma requisição à API do BuscaPé. Ela realiza a procura pelos dados da empresa, cujo código foi passado como parâmetro, e retorna os detalhes cadastrados para a afiliada.

Como utilizar o método?

Para utilizar o método ViewSellerDetails, primeiro instancie a classe Apiki_Buscape_API informando o código da aplicação no BuscaPé.

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

Adicionalmente, podemos informar ao construtor da classe o código do
país de origem (countryCode) da nossa aplicação e o formato de retorno
(format) dos dados da API do BuscaPé. Se não informados, esses
parâmetros assumirão os valores padrão “BR” e “xml”, respectivamente.

Apiki_Buscape_API.Apiki_Buscape_API apiBuscape = new Apiki_Buscape_API.Apiki_Buscape_API( "564771466d477a4458664d3d", "AR", "json" );

Uma vez instanciada a classe, podemos agora utilizar o método ViewSellerDetails, informando apenas o código da afiliada (SellerId). Se desejar, informe também uma função de retorno para ser executada, caso o retorno seja no formato JSON.

// Informando o código da afiliadaapiBuscape.ViewSellerDetails(65); // Informando o código da afiliada e uma função de retorno para o jsonapiBuscape.ViewSellerDetails(65, "trata_retorno");

O retorno do método será de acordo com o formato informado no construtor da classe:

– XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" totalResultsReturned="1" totalResultsAvailable="1" xsi:schemaLocation="http://developer.buscape.com/xsd/buscape.xsd">   <details>       <applicationID>564771466d477a4458664d3d</applicationID>       <applicationVersion>1.0.0.0</applicationVersion>       <applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>       <date>2010-11-29T10:44:46.358</date>       <elapsedTime>6</elapsedTime>       <status>success</status>       <code>0</code>       <message>success</message>   </details>   <seller pagamentoDigital="false" isTrustedStore="true" id="65">       <sellerName>Submarino</sellerName>       <thumbnail url="http://imagem2.buscape.com.br/vitrine/logo65.gif"/>       <links>           <link type="seller" url="http://www.submarino.com.br/?franq=102414"/>       </links>       <extra>Vende pela Internet</extra>       <contacts>           <contact label="SAC" value="4003-5544"/>           <contact label="Televendas" value="4003-2000"/>       </contacts>       <rating>           <userAverageRating>               <numComments>7394</numComments>               <rating>7.0</rating>           </userAverageRating>       </rating>   </seller></Result>

– JSON

{"details":{"message":"success","elapsedtime":1,"status":"success","code":0,"applicationversion":"1.0.0.0","date":{"minute":15,"valid":true,"timezone":-2147483648,"second":42,"millisecond":245,"month":11,"year":2010,"hour":11,"day":29,"xmlschematype":{"namespaceuri":"http://www.w3.org/2001/XMLSchema","prefix":"","localpart":"dateTime"},"eonandyear":{"lowestsetbit":1}},"applicationpath":"http://bws-apps.buscape.com/mobile/update","applicationid":"564771466d477a4458664d3d"},"totalresultsavailable":1,"seller":{"id":65,"thumbnail":{"url":"http://imagem2.buscape.com.br/vitrine/logo65.gif"},"extra":"Vende pela Internet","sellername":"Submarino","links":[{"link":{"type":"seller","url":"http://www.submarino.com.br/?franq=102414"}}],"rating":{"useraveragerating":{"rating":"7.0","numcomments":7394}},"istrustedstore":true,"pagamentodigital":false,"contacts":[{"contact":{"value":"4003-5544","label":"SAC"}},{"contact":{"value":"4003-2000","label":"Televendas"}}]},"totalresultsreturned":1}

Aproveite para conhecer mais sobre a API do BuscaPé com a nossa documentação. E não deixe comentar neste artigo e de participar do nosso fórum de discussão.