APIs e Microsserviços

13 out, 2011

Como integrar um aplicativo Lomadee utilizando o Wrapper .NET

Publicidade

O objetivo deste artigo é explicar como se integra um aplicativo à Lomadee, para desta forma, torná-lo oficial. Para isso, é preciso seguir um fluxo de integração.

Antes de começar, efetue o download da nova versão do Wrapper .Net
e adicione o arquivo da classe ao seu projeto, ou se preferir, apenas
adicione uma referência à biblioteca compilada da classe (.dll) que
também está disponível para download.

Integrar seu aplicativo à Lomadee significa dizer que você terá um
aplicativo oficial, que estará disponibilizado no Market Place da
Lomadee e acessível para qualquer publisher utilizá-lo. Porém, para
permitir que algum publisher o utilize, é necessário criar
um código de integração. Para tal fluxo, incluímos no Wrapper .Net os
métodos necessários para isso.

Inicialmente, instale um objeto da classe Apiki_BuscaPé_API informando nosso AplicationId:

Apiki_Buscape_API.Apiki_Buscape_API apiBuscape = new Apiki_Buscape_API.Apiki_Buscape_API("564771466d477a4458664d3d");

O primeiro passo da integração é gerar o SourceId para o publisher, através do método CreateSource. Esse método espera os seguintes parâmetros:

  • siteId: O ID do site do publisher em que o código será utilizado;
  • publisherId: O ID do publisher que utilizará o nosso aplicativo;
  • token: Token de segurança;
  • sourceName: O Nome que o publisher deu para seu source.

Label1.Text = apiBuscape.CreateSource("11545", "21894", "754e2b32746751514c397a456c6734337231496e70673d3d", "Meu nome");

Esse método retornará um tipo string contendo o XML retornado pela API
da Lomadee. Por esse XML você pode facilmente identificar o sourceId
gerado para o publisher pelo nó source.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" totalResultsReturned="0" totalResultsAvailable="0" xsi:schemaLocation="http://developer.buscape.com/admin/lomadee.xsd">
<details>
<applicationID>564771466d477a4458664d3d</applicationID>
<applicationVersion>1.0.0.0</applicationVersion>
<applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>
<date>2011-09-13T08:49:08.127-03:00</date>
<elapsedTime>3523</elapsedTime>

<status>success</status>
<code>0</code>
<message>success</message>
</details>
<source id="9262544"/>

Com o SourceId gerado, deve-se, agora, informar à
Lomadee qual será o código que o publisher utilizará em seu site. Para
isso, utilize o método SaveCode, informando os seguintes parâmetros:

  • siteId: O ID do site do publisher em que o código será utilizado;
  • publisherId: O ID do publisher que utilizará o nosso aplicativo;
  • token: Token de segurança;
  • sourceId: SourceId gerado para o publisher;
  • code: Código que será utilizado pelo publisher em seu site.
apiBuscape.SaveCode("11545", "21894", "754e2b32746751514c397a456c6734337231496e70673d3d", "9262544", "Seu JS/HTML aqui");

Agora, com o código salvo na Lomadee,informe-o ao publisher
para que ele possa copiá-lo e colá-lo em seu site. Para isso, existe o
método GetCode, que retorna o código gerado, informando apenas o SourceId do publisher.

Label2.Text += apiBuscape.GetCode("9262544");

Da mesma forma, esse método retorna uma string contendo o xml de retorno
da Lomadee. Pode-se encontrar o código a ser exibido para o publisher
dentro do nó codeDetails code.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" totalResultsReturned="0" totalResultsAvailable="0" xsi:schemaLocation="http://developer.buscape.com/admin/lomadee.xsd">
<details>
<applicationID>564771466d477a4458664d3d</applicationID>
<applicationVersion>1.0.0.0</applicationVersion>
<applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>

<date>2011-09-13T08:58:27.097-03:00</date>
<elapsedTime>20</elapsedTime>
<status>success</status>
<code>0</code>
<message>success</message>
</details>

<codeDetails>
<source id="9262544"/>
<code><!-- LOMADEE - BEGIN --><div align="right">Code Default</div><div align="right">Lomadee, uma nova espécie na web. A maior plataforma de afiliados da América Latina.</div><!-- LOMADEE - END --></code>
</codeDetails>

</Result>

Pronto, agora é só aguardar que o publisher utilize esse código para
monetizar seu site. Dessa forma, você, desenvolvedor, também receberá 20%
da comissão do publisher.