Caso seja de seu interesse integrar o seu aplicativo à Lomadee, é necessário criar um código de integração. Dentro do fluxo de integração, o aplicativo utiliza esse serviço para criar o sourceId (código) para o Publisher que deseja utilizá-lo.
Serviço utilizado somente na integração do Aplicativo com a Lomadee. Dentro do fluxo de integração, o aplicativo utiliza esse serviço para criar sourceId (código) para o Publisher que deseja utiliza-lo.
Como funciona?
Os parâmetros necessários neste serviço são informados pela própria Lomadee ao aplicativo. No ambiente de homologação sandbox, os valores dos parâmetros podem ser fictícios pois neste ambiente este serviço retornará sempre o mesmo sourceId para os testes do Developer.
Fluxo de integração
1 - Publisher seleciona o aplicativo do Developer.
2 - Define um nome para o código e seleciona o site. Ao clicar em "avançar", abrirá a primeira tela do aplicativo do Developer.
3 - Nessa tela, o aplicativo exibirá suas configureações, como por exemplo tamanho do banner, cor, categoria, palavra-chave, etc, (depende das características de cada aplicação). O aplicativo receberá alguns parêmetros da Lomadee via URL que serão passados ao BWS para criar um código.
4 - O aplicativo exibirá o código criado que poderá ser um javascript, iframe. O código exibido será utilizado pelo Publisher em seu site, blog, etc, fazendo com que a chamada seja direcionada diretamente para o aplicativo, exibindo o banner ou qualquer outra funcionalidade.
URLs do serviço
Cria código para o publisher 20444, site 1234 e nome Daniel:
O parâmetro categoryId deve ser sempre o ID de uma categoria final.
Algumas categorias finais não possuem ofertas, apenas produtos. Neste caso a resposta do XML retornará uma lista de ofertas vazia. Para não perder o vinculo da consulta, o serviço disponibilizará a URL pronta para consulta dos produtos, informando o mesmo ID da categoria.
Aviso aos desenvolvedores
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:
Caso o aplicativo, sistema ou site utilize cache, o mesmo deverá ser de, no máximo, uma hora para produtos e categorias. No caso de ofertas, como o clique é validado através do IP do usuário e pela hora do clique, o cache não pode existir pois, se dois IP's acessam o mesmo link de oferta, o clique é invalidado.
