5. srpen 2020
Webhook
Předávání dat z Mailocatoru prostřednictvím Webhooku třetím stranám
Podporované formáty dat
Formáty dat: pole
name=value&...
, XML, JSON a data agregovaná do POST proměnné data
Podporované HTTP metody
Většinu formátů lze kombinovat s HTTP metodami GET, POST nebo PUT
Základní struktura předaných dat
V každém požadavku jsou vrácená minimálně tato pole (proměnné):
Volitelně mohu být přidaná další data z formuláře pop-upu odeslaná akcí
engine
- obsahuje "Mailocator"time
- obsahuje unix timestamp odeslání požadavkuemail
- obsahuje platnou e-mailovou adresuVolitelně mohu být přidaná další data z formuláře pop-upu odeslaná akcí
subscribe
Příklady
Požadavek s metodou POST a formátem JSON
Vrácená data, výsledek volání funkce PHP
Vrácená data, výsledek volání funkce PHP
var_export($_POST,1)
Požadavek s metodou POST a formátem XML
Vrácená data, výsledek volání funkce PHP
Vrácená data, výsledek volání funkce PHP
var_export($_POST,1)
array ('<?xml version="1.0"?>
<contact>
<engine>Mailocator</engine>
<time>1596634651</time>
<email>test@mlctr.com</email>
</contact>'
Požadavek s metodou POST a formátem XML
Vrácená data, výsledek volání funkce PHP
Vrácená data, výsledek volání funkce PHP
file_get_contents('php://input')
<?xml version="1.0"?>
<contact>
<engine>Mailocator</engine>
<time>1596634651</time>
<email>test@mlctr.com</email>
</contact>
Očekávané návratové kódy ze serveru třetí strany:
1
- kontakt byl úspěšně uložený, Mailocator zobrazí poděkování0
- kontakt nebyl úspěšně uložený, Mailocator zobrazí informaci o duplicitním kontaktuPři jiném nebo prázdném obsahu je proces zpracování Mailocatorem přerušený, v monitoringu je zapsaná chyba.
Příklad v PHP
Po úspěšném zpracování požadavku na serveru stačí zavolat
echo '1';
, navrácená hodnota je interpretovaná jako správně uložený kontakt.