Como obter detalhes de uma empresa através da API do BuscaPé

Utilizaremos agora o serviço View Seller Details disponibilizado pela API do BuscaPé, que retorna os dados de endereço, telefones de contato e ainda de latitude e de longitude para uso em mapas virtuais.
Como funciona este recurso?



Informando o ID da empresa ao View Seller Details, há o retorno de suas principais informações por meio de uma requisição feita à API do BuscaPé.
Como requisitar este serviço à API do BuscaPé?

A API do BuscaPé utiliza a tecnologia REST no tratamento de requisições, sendo possível construir facilmente uma URL para ser executada em seu navegador, linha de comando ou código.

Veja um exemplo de formato para requisição deste serviço:
===================================================================================
http://sandbox.buscape.com/service/viewSellerDetails/application_id/?sellerId=seller_id
===================================================================================

Esse é o formato padrão de URL para requisitar este serviço. Como mostrado no exemplo acima, são necessários os IDs de sua aplicação e da empresa da qual se deseja obter os detalhes. Aprenda aqui como obter um ID para sua aplicação, caso ainda não o possua.
Formatos de retorno

Por padrão, todos os serviços da API do BuscaPé têm como formato de retorno o XML.
==================================================================================

==================================================================================

Também podemos obtê-lo em JSON. Veja o exemplo abaixo:
==================================================================================
http://sandbox.buscape.com/service/viewSellerDetails/application_id/?sellerId=seller_id&format=json
==================================================================================

==================================================================================
{"details":{"message":"success","elapsedtime":6,"status":"success","code":0,"applicationversion":"1.0.0.0","date":{"minute":30,"valid":true,"timezone":-2147483648,"second":1,"millisecond":877,"month":9,"year":2010,"hour":15,"day":13,"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":335525,"cpc":"0.000","extra":"Loja em MG, Contagem, Eldorado","sellername":"Assunção Escapamento","links":[{"link":{"type":"seller","url":""}}],"rating":{"useraveragerating":{"rating":"0.0","numcomments":0}},"addresses":[{"address":{"complement":"3168","postalcode":"32340000","name":"Assunção Escapamento","map":{"longitude":"-44.052960000","latitude":"-19.938570000"},"state":"MG","fone":"31-33551606","postalarea":"Avenida João César de Oliveira","district":"Eldorado","city":"Contagem"}}],"istrustedstore":false,"pagamentodigital":false,"contacts":[{"contact":{"value":"31-33551606","label":"Atendimento"}}]},"totalresultsreturned":1}
===================================================================================

Como XML é padrão, não é necessário informar parâmetro algum para retornos utilizando esse tipo de formato.
Wrappers

O BuscaPé Developer disponibiliza wrappers em PHP e .NET para ajudá-lo na integração. Ao instanciar a classe, chame o método ViewSellerDetails, informando os parâmetros requisitados.

Aprenda mais sobre como obter dados de uma loja ou empresa e como funciona a API do BuscaPé.

Conheça também outros serviços oferecidos.

iMasters