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 naujienališkiui ir t.t.)

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

Mailer.lt API specifikacija

Prisijungimas prie API

$client = new SoapClient(null, array('location' => "http://mailer.lt/api.php", 'uri' => "urn://mailer.lt"));
$session_id = $client->login('subdomenas', 'soap', 'slaptažodis');

API funkcijų aprašymas

addSubscriber ($session_id, $group_id, $email, $name = null)

Parametruose nurodome grupės ID, vartotojo el. pašto adresą ir vardą (nebūtinas). Taip pat galime $extra_fields masyve nurodyti papildomas reikšmes. Galimi laukai - surname, company, gender, birth_date, city, country, extra1, extra2, extra3.

Pavyzdys 1:

$client->addSubscriber($session_id, 7777, `vardas@domenas.lt`,`Vardas`);

Pavyzdys 2:

$client->addSubscriber($session_id, 7777, `vardas@domenas.lt`,Vardas`,
array(`gender` => `m`, `city` => `Vilnius`));

Funkcija grąžina „–1” jei gavėjas sėkmingai įrašytas į Mailer.lt duomenų bazę. Kitu atveju gražinamas klaidos kodas:

  • 1 – klaidingas sesijos ID
  • 2 – neįvestas el. pašto adresas
  • 3 – neteisingas el. pašto adreso formatas
  • 4 – neteisingas grupės ID
  • 5 – toks el. pašto adresas jau buvo įvestas

Jei vartotojas, kuris jau egzistuoja sistemoje ir yra pažymėtas kaip neaktyvus, bus įvestas dar kartą į sistemą, jo statusas nebus keičiamas. Pakeisti statusą galima pasinaudojus žemiau aprašyta funkcija.

$client->changeStatus($session_id, $email, $status = 0)

Parametruose nurodome el. pašto adresą ir statusą:

  • 0 – aktyvus
  • 1 - neaktyvus

Funkcija grąžina „–1” jei gavėjo statusas sėkmingai pakeistas. Kitu atveju gražinamas klaidos kodas:

  • 1 – klaidingas sesijos ID
  • 2 – neįvestas el. pašto adresas
  • 3 – neteisingas el. pašto adreso formatas
  • 4 – el. pašto adresas neegzistuoja

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