Dokumentacja API programu SMSer
Transkrypt
Dokumentacja API programu SMSer
Dokumentacja API programu SMSer Spis treści Wprowadzenie .................................................................................................................................... 2 Wysyłanie wiadomości SMS ................................................................................................................ 3 Przykład użycia .................................................................................................................................... 4 1 Wprowadzenie SMSer - system do zarządzania numerami telefonów i wysyłania kampanii SMS. Wykorzystaj potencjał telefonii komórkowej, używając bardzo przydatnych funkcji oferowanych przez nasz system. Dzięki zaawansowanym statystykom, w prosty i szybki sposób dowiesz się ile SMSów zostało dostarczonych do adresatów. API programu pozwala na wykorzystywanie funkcji naszego serwisu bez konieczności logowania się do systemu. Komunikacja z SMSer odbywa się poprzez wywołanie adresu URL metodą POST z odpowiednimi parametrami. Jako odpowiedź zwracany jest tekst informujący o powodzeniu akcji bądź przyczynach niepowodzenia. 2 Wysyłanie wiadomości SMS Aby przy pomocy API wysłać wiadomość SMS należy przesłać parametry metodą POST na określony adres URL. Adres API: http://system.adsmser.com/api.php Aby wygenerować Token potrzebny do zalogowania się przy pomocy API, należy w zakładce 'Ustawienia' -> 'Dane do logowania' wybrać opcję 'Wygeneruj token'. Dostępne parametry Parametr login token Typ String String Przykładowa wartość [email protected] 849ascz8asd7qwd action String send number String +48500123123 message String Tresc wiadomosci 3 Opis Adres email naszego konta Token wygenerowany dla naszego konta Akcja jaką chcemy wykonać. Do wysyłki wiadomości SMS służy akcja 'send' Numer telefonu, na który chcemy przesłać wiadomość SMS Treść wiadomości SMS Przykład użycia $requestUrl = 'http://system.adsmser.com/api.php'; $params = array('login'=>'[email protected]', 'token'=>'TOKEN', 'action'=>'send', 'number'=>'123456789', 'message'=>'Testowa wiadomosc wyslana przy pomocy API adSMSera!'); $curl = curl_init($requestUrl); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($params)); curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); curl_setopt($curl, CURLOPT_TIMEOUT, 30); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); $answer = curl_exec($curl); if (curl_errno($curl)) { die('<pre style="color:red">' . curl_error($curl) . ':' . curl_errno($curl) . '</pre>'); exit(); } curl_close($curl); print $answer; 4