Os serviços Web modernos normalmente permitem o acesso externo aos seus dados por meio de APIs e Web Services, assim qualquer programador pode criar novas aplicações usando a inteligência e infra-estrutura do serviço original.

A boo-box está renovando a boo-api, com ela você pode usar nosso sistema de recomendações e criar suas próprias aplicações de recomendação de produtos.

Chamada

Para fazer buscas usando a nossa API, é muito simples, basta fazer uma requisição para:

Exemplo de requisição:

Para uso no jQuery com a técnica JSONP, finalize a URL com “/jsonp:=?”. Exemplo:

Parâmetros obrigatórios:

• format: o formato de retorno desejado, pode ser:
  • json
  • xml
• aff: O identificador do programa de afiliados, identifica também o e-commerce no qual a API vai fazer a busca por produtos, pode ser:
  • americanasid
  • amazonid
  • amazonukid
  • amazonjpid
  • amazonfrid
  • amazondeid
  • buscapeid
  • ebayid
  • jacoteiid
  • mercadolivreid
  • submarinoid
• uid: O seu código identificador no programa de afiliados, é a partir deste código que o programa de afiliados irá efetuar o pagamento. Este ID precisa estar cadastrado em um profile de usuário no Sistema boo-box.
• tags: Os parâmetros de busca, palavras separadas por + ou espaços, múltiplas tags separadas por virgula. A primeira requisicão trará produtos aleatórios, nosso sistema de cache demora em média 1 minuto pra retornar os produtos da busca.
• limit: Um número inteiro que diga o máximo de produtos que você quer receber como resposta. Sempre que possível peça 6 produtos para usar melhor nosso sistema de cache.

Resultado

Será retornado um XML ou JSON (veja um exemplo), com uma estrutura bem simples:

As informações sobre os itens ficam dentro do array _value, que possui os seguintes parâmetros:

• _name: título do produto
• price: preço do produto
• img: url da imagem
• url: URL do produto em nosso sistema
• uid: código de afiliado
• shop: id do shopping utilizado
• saved: data da primeira vez que o produto foi visto e cacheado
• first_keyword: tags que retornaram esse produto pela primeira vez

Mais sobre este tema:

• Post de lancamento da boo-api
• Detalhes do XML
• Tudo sobre nossa API