Dicas e informações que o desenvolvedor de aplicativos para o BuscaPé deve conhecer

Para você obter mais agilidade no desenvolvimento de aplicativos para o BuscaPé, nós disponibilizamos toda a documentação de nossa API para que você desenvolvedor possa usufruir e obter as respostas de suas mais variadas dúvidas em um só lugar. Também temos disponíveis wrappers em PHP, .NET, Java, Python e Js, para agilizar o desenvolvimento, uma vez que os wrappers cuidam de toda a integração com a API do BuscaPé, bastando apenas informar os parâmetros corretos no método desejado.

Para dar início ao desenvolvimento e testar sua aplicação, o BuscaPé disponibiliza um ambiente de testes (sandbox) e suas requisições devem ser feitas ao subdomínio sandbox.buscape.com. Após a homologação de sua aplicação junto ao BuscaPé, as requisições devem ser feitas ao ambiente de produção usando o subdomínio bws.buscape.com.

Por padrão, o retorno dos dados da API do BuscaPé sempre será no formato XML, mas podemos obtê-lo em formato JSON, informando o parâmetro &format=json na requisição.

Em alguns serviços, é possível obter produtos/ofertas informando um ID de categoria no qual esses produtos/ofertas devem estar relacionados. Esse ID deve ser sempre de uma categoria final. Saiba mais sobre os tipos de categoria e como obtê-las.

Algumas categorias finais não possuem produtos, apenas ofertas. Nesse caso, a resposta do XML terá sua lista de produtos vazia. Para não perder o vínculo da consulta, o serviço disponibilizará a URL pronta para consulta das ofertas, informando o mesmo ID da categoria.

Caso o seu aplicativo seja executado em um servidor, é necessário informar aos webservices do BuscaPé o IP do usuário que acessa o seu servidor. O IP do usuário deve ser informado através do parâmetro clientIp. Caso o seu aplicativo seja executado diretamente na máquina do usuário final, como aplicações mobile ou javascript, não é necessário informar o IP do usuário. Se, por exemplo, o IP do usuário que acessou o seu servidor seja 200.200.200.200, a chamada deveria ser feita assim:

http://sandbox.buscape.com/service///?param=&clientIp=200.200.200.200

Para mais dicas e informações importantes, acesse nosso blog e fórum de discussões.