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į.