APIs e Microsserviços

20 abr, 2011

Como obter uma lista de ofertas no BuscaPé usando o wrapper para PHP

Publicidade

Busque todas as ofertas de um determinado produto usando o serviço Find Offer List, disponibilizado pela API do BuscaPé.
As ofertas podem ser obtidas filtrando-as por um ID de categoria,
palavras-chave, ID do produto, código de barras e muito mais.

O wrapper PHP
do BuscaPé Developer é mantido por desenvolvedores de todo o mundo e
está em fase de crescimento constante, devido à grande colaboração de
grandes desenvolvedores e empresas participantes do projeto. O wrapper
PHP tem como finalidade ajudar e agilizar o desenvolvimento de
aplicações voltadas para o BuscaPé. Faça o download do wrapper e o conheça.

Após efetuar o download, você poderá incluir o wrapper PHP em sua
aplicação e fazer o uso de suas funcionalidades e facilidades
disponibilizadas. Como mostrado na figura abaixo, os testes iniciais à
integração de sua aplicação com a API do BuscaPé podem ser feitos usando
o arquivo “index.php” na pasta “example” existente dentro do pacote de
arquivos do wrapper.

Os próximos passos na integração são entender como o wrapper funciona e
como chegamos ao resultado esperado. Conforme a imagem abaixo, temos
alguns passos iniciais a serem configurados antes de solicitarmos o que
queremos à API do BuscaPé.

  1. Inclua a classe Apiki BuscaPé API, representada pelo wrapper PHP, em sua aplicação.
  2. Configure o ID da sua aplicação, assim como o Source ID;
  3. Instancie a classe passando como parâmetro o ID da aplicação e o Source ID;
  4. Defina o ambiente de testes sandbox para testar sua aplicação;
  5. Use o método do wrapper desejado, nesse caso o findOfferList.

OBS: O parâmetro Source ID não é
obrigatório durante a fase de testes da aplicação. Pode-se passar apenas
o ID da aplicação como parâmetro.

Para obter os dados da API do BuscaPé, é muito simples. Após as
configurações iniciais já citadas, precisamos chamar o método do wrapper
referente ao serviço que queremos usar, nesse caso o findOfferList. Passe os parâmetros desejados e aceitos para uma melhor filtragem das ofertas.

  • Buscando uma lista de ofertas através do ID da uma categoria final,
    ou seja, todas as ofertas relacionadas a uma categoria final específica.
    Veja o resultado.
$objBuscaPeApi->findOfferList( array(  'categoryId' => 3482 )  );
  • Para obter uma lista de ofertas através do ID de um produto, ou seja, todas as ofertas relacionadas ao ID do produto informado. Veja o resultado.
$objBuscaPeApi->findOfferList( array(  'productId' => 240493 )  );
  • Podemos também obter listas de ofertas filtrando por código de
    barras, palavras-chave e ID da categoria juntamente com uma ou mais
    palavras-chave.
$objBuscaPeApi->findOfferList( array(  'barcode' => 36475937 )  );
$objBuscaPeApi->findOfferList( array(  'keyword' => 'Apple' )  );
$objBuscaPeApi->findOfferList( array(  'categoryId' => 1234, 'keyword' => 'Apple' )  );

É isso pessoal, essas são as dicas iniciais para quem quer começar a desenvolver para o BuscaPé. Participem da comunidade e ajudem a melhorar ainda mais nosso wrapper.