Mailer.lt API

Mailer.lt API leidžia lengvai ir paprastai sinchronizuoti el. pašto adresų įvedimą tiesiai iš kliento informacinės sistemos į Mailer.lt duomenų bazę.

Kada naudoti Mailer.lt API?

  • Kai savo tinklalapyje jau turite gerai veikiančią vartotojų registracijos formą
  • Kai norite, kad vartotojų duomenys būtų saugomi ir Jūsų sistemoje, ir Mailer.lt
  • Kai turite keletą skirtingų vartotojų duomenų surinkimo procesų (pavyzdžiui vartotojų registracija, pirkimas, registracija specialiems pasiūlymams, registracija naujienlaiškiui ir t.t.)

Jeigu norite paprastesnio būdo rinkti savo klientų duomenis - Mailer.lt gavėjų registracijos forma.

Mailer.lt API specifikacija

WSDL

http://mailer.lt/soapserver.php?wsdl

API funkcijų aprašymas

addSubscriber

Pavyzdys:

$client = new nusoap_client("http://www.mailer.lt/soapserver.php?wsdl");    
$params = array(
"api_key" => "xxxxxxxxxxxxxxxxxxxxxxxxx",
"group_id"  =>  xxxx,
"email" => "vardas@domenas.lt",
 "name" => "Vardas"
 );
$result = $client->call("addSubscriber", $params);

Parametrai:

  • api_key - xxxxxxxxxxxxxxxxxxxxxxxxx (Rasite prisijungę prie savo Mailer.lt paskyros)
  • group_id - grupės, į kurią įrašinėsite ID
  • email - gavėjo el. pašto adresas
  • name - gavėjo vardas

Grąžinimo reikšmės:

  • 0 - gavėjas sėkmingai įrašytas
  • 1 - neteisingas el. pašto adresas
  • 100 - neteisingas sąsajos raktas
  • 101 - neteisingas grupės ID
  • 201 - gavėjas yra atsisakęs naujienlaiškio
  • 202 - gavėjas yra atmestas
  • 203 - gavėjas yra nepatvirtinęs savo el. pašto adreso

addSubscriberWithCustomFields

Pavyzdys:

$client = new nusoap_client("http://www.mailer.lt/soapserver.php?wsdl");    
$params = array(
"api_key" => "xxxxxxxxxxxxxxxxxxxxxxxxx",
"group_id"  =>  xxxx,
"email" => "vardas@domenas.lt",
"name" => "Vardas"
"fields" => array(array("name" => "laukelio_pavadinimas", "value" => 1))
);
$result = $client->call("addSubscriberWithCustomFields", $params);

Parametrai:

  • api_key - xxxxxxxxxxxxxxxxxxxxxxxxx (Rasite prisijungę prie savo Mailer.lt paskyros)
  • group_id - grupės, į kurią įrašinėsite ID
  • email - gavėjo el. pašto adresas
  • name - gavėjo vardas
  • CustomFields - masyvas, kurį sudaro kintamasis/reikšmė elementai (kintamųjų pavadinimai nurodyti prie grupės, į kurią bus įrašomi adresai, duomenų laukelių)

Grąžinimo reikšmės:

  • 0 - gavėjas sėkmingai įrašytas
  • 1 - neteisingas el. pašto adresas
  • 100 - neteisingas sąsajos raktas
  • 101 - neteisingas grupės ID
  • 201 - gavėjas yra atsisakęs naujienlaiškio
  • 202 - gavėjas yra atmestas
  • 203 - gavėjas yra nepatvirtinęs savo el. pašto adreso

Pavyzdyje naudojamą NuSOAP biblioteką galite atsisiųsti iš čia.

Jeigu norite pradėti naudotis Mailer.lt API, susisiekite el. paštu info@mailer.lt ir suteiksime Jums API vartotojo vardą bei slaptažodį.