Mailocator
menu

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é):
engine - obsahuje "Mailocator"
time - obsahuje unix timestamp odeslání požadavku
email - obsahuje platnou e-mailovou adresu

Volitelně 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 var_export($_POST,1)


array (
'{"engine":"Mailocator","time":1596634651,"email":"test@mlctr_com"}' => '',
)







Požadavek s metodou POST a formátem XML
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 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 kontaktu

Př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.

POMOHL VÁM TENTO ČLÁNEK?

  

Společnost Mailnatives, s.r.o. s IČO 07891768 je vedená u Krajského soudu v Hradci Králové pod spisovou značkou C 43368