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