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é dataPodporované 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í
subscribePří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.