Eu utilizo um serviço de newsletter que demanda a instalação de um kit de desenvolvimento (SDK). Esse SDK possui várias funções, contudo, a função que preciso é a de cadastro do inscrito em uma lista específica.

Resumo do trabalho: criar uma API (vamos chamar de “API Nova”) que irá receber os dados via requisição POST (com autenticação), pegar esses dados e enviar para a API da newsletter.

A documentação da API da newsletter está aqui > https://api-docs.mailwizz.com/

Como eu tenho algumas aplicações diferentes (que podem ser listas diferentes da aplicação da newsletter), a API Nova poderá ter vários endpoints. Cada endpoint será um arquivo específico (‘endpoint.php’).

De acordo com a documentação da API da newsletter, também há a necessidade de um arquivo chamado ‘setup.php’. Logo, na API Nova, cada arquivo ‘endpoint.php’ terá o seu ‘setup-endpoint.php’

O arquivo ‘setup-endpoint.php’ deverá conter (i) os tokens bearer que poderão se autenticar com a API Nova; (ii) o ID da lista onde o e-mail será cadastrado (LIST-UNIQUE-ID); e (iii) uma função de debug (false/true).

O Debug, se ativo, deverá criar um arquivo que conterá o que foi feito na API Nova e a resposta da API da newsletter.

As informações que serão transmitidas para a API Nova estarão assim (é uma ideia, passível de ajustes):

{
"EMAIL": "fulano@me.com"
"FNAME": "fulano "
"LNAME": "da silva"
"CUSTOM1": "xxxxx"
"XXXX": "xxxxxx"
}

Elas já estarão com os mesmos campos da API da newsletter. A API Nova pegará essas informações, formatará e repassará para a API da newsletter.

Com a resposta da API da newsletter, a API Nova transmitirá a resposta para a origem da requisição. A resposta da API da newsletter (para cadastro de inscrito), de acordo com a documentação (link acima), é assim:

{
"status":"success",
"data": {
"record": {
"subscriber_uid": "bm421c3lwe043",
"email": "john.doe@doe.com",
"ip_address": "5.13.134.200",
"source": "api",
"date_added": {
"expression": "NOW()",
"params": {}
}
}
}
}

Nenhuma informação será salva na API Nova, ela só deve funcionar para realizar esse procedimento de cadastro da inscrito ou do e-mail do usuário.

Condições:

- o valor do projeto deve ser fechado, não aceitarei propostas por hora;
- propostas genéricas serão negadas ou que fique claro que o profissional não leu a descrição, serão negadas;
- o projeto será considerado entregue quando a API Nova for testada e estiver funcionando corretamente (fazendo a interação com a API da Newsletter);
- sugestões são bem-vindas.