Spis treści
1. Najnowższa specyfikacja smsAPI.
2. Przykłady wysyłania SMSa w PHP.
3. Opis korzystania z usługi mailtosms.
4. Wysyłanie wiadomości WAP PUSH.
5. Wysyłanie wiadomości vCard.
6. Wysyłanie wiadomości o określonej godzinie/dacie.
2. Przykłady wysyłania SMSa w PHP.
3. Opis korzystania z usługi mailtosms.
4. Wysyłanie wiadomości WAP PUSH.
5. Wysyłanie wiadomości vCard.
6. Wysyłanie wiadomości o określonej godzinie/dacie.
1. Specyfikacja smsAPI.
Specyfikacja smsAPI zawiera opis m.in.:
Wysyłki SMS poprzez http, https, mail2SMS, Web Services(SOAP),
odbiór SMS, MMS,
wysyłka WAP PUSH, vCard, wiadomości zaplanowanych oraz spresonalizowanych.
Ściągnij najnowszą specyfikację smsAPI 2.9 (08.07.2010)
Wysyłki SMS poprzez http, https, mail2SMS, Web Services(SOAP),
odbiór SMS, MMS,
wysyłka WAP PUSH, vCard, wiadomości zaplanowanych oraz spresonalizowanych.
Ściągnij najnowszą specyfikację smsAPI 2.9 (08.07.2010)2. Przykłady wysyłania SMSa w PHP.
UWAGA! Hasło należy podać w formie zaszyfrowanej algorytmem MD5! W celu wygenerowania hasła md5 należy użyć narzędzia dostępnego w zakładce Narzędzia.
Przykład nr 1 - bezpośrednie wysyłanie sms z poziomu PHP.
Przykład nr 2 - wysyłanie sms z formularza HTML z poziomu PHP.
Przykład nr 3 - wysyłanie sms do wielu odbiorców przy wykorzystaniu biblioteki cURL.
Przykład nr 1 - bezpośrednie wysyłanie sms z poziomu PHP.
<?php
$username = "uzytkownik";
$password = md5("haslo"); //lub $password="ciąg md5"
$to = "48505605705";
$from= urlencode("nadawca"); //nazwa nadawcy musi być aktywna
$message= urlencode("moja wiadomosc");
if ($username && $password && $to && $message) {
$data = "?username=$username&password=$password"
."&to=$to&message=$message&from=$from";
$plik = fopen('http://api.smsapi.pl/send.do'.$data,'r');
$wynik = fread($plik,1024);
fclose($plik);
echo $wynik;
}
?>
$username = "uzytkownik";
$password = md5("haslo"); //lub $password="ciąg md5"
$to = "48505605705";
$from= urlencode("nadawca"); //nazwa nadawcy musi być aktywna
$message= urlencode("moja wiadomosc");
if ($username && $password && $to && $message) {
$data = "?username=$username&password=$password"
."&to=$to&message=$message&from=$from";
$plik = fopen('http://api.smsapi.pl/send.do'.$data,'r');
$wynik = fread($plik,1024);
fclose($plik);
echo $wynik;
}
?>
Przykład nr 2 - wysyłanie sms z formularza HTML z poziomu PHP.
<?php
if (strlen($_POST['sms_from'])>0 &&
strlen($_POST['sms_to'])>=9 &&
strlen($_POST['sms_message'])>0)
{
$username = "login";
$password = md5("haslo"); //lub $password="ciąg md5"
$from = urlencode($_POST['sms_from']);
$to = $_POST['sms_to'];
$message= urlencode($_POST['sms_message']);
echo file_get_contents("http://api.smsapi.pl/send.do?".
"username=$username&password=$password&to=$to&".
"message=$message&from=$from",FALSE,NULL,0,100);
}
?>
<html>
<head>
<meta http-equiv="Content-type" content="text/html; charset=windows-1250">
</head>
<body>
<form name="sms" method="POST" action="">
<table>
<tr>
<td>Od:</td>
<td><input type="text" name="sms_from" value=""></td>
</tr>
<tr>
<td>Do:</td>
<td><input type="text" name="sms_to" value=""></td>
</tr>
<tr>
<td>Wiadomość:</td>
<td><textarea name="sms_message"></textarea></td>
</tr>
<tr>
<td colspan="2"><input type="submit" value="wyślij"></td>
</tr>
</table>
</form>
</body>
</html>
if (strlen($_POST['sms_from'])>0 &&
strlen($_POST['sms_to'])>=9 &&
strlen($_POST['sms_message'])>0)
{
$username = "login";
$password = md5("haslo"); //lub $password="ciąg md5"
$from = urlencode($_POST['sms_from']);
$to = $_POST['sms_to'];
$message= urlencode($_POST['sms_message']);
echo file_get_contents("http://api.smsapi.pl/send.do?".
"username=$username&password=$password&to=$to&".
"message=$message&from=$from",FALSE,NULL,0,100);
}
?>
<html>
<head>
<meta http-equiv="Content-type" content="text/html; charset=windows-1250">
</head>
<body>
<form name="sms" method="POST" action="">
<table>
<tr>
<td>Od:</td>
<td><input type="text" name="sms_from" value=""></td>
</tr>
<tr>
<td>Do:</td>
<td><input type="text" name="sms_to" value=""></td>
</tr>
<tr>
<td>Wiadomość:</td>
<td><textarea name="sms_message"></textarea></td>
</tr>
<tr>
<td colspan="2"><input type="submit" value="wyślij"></td>
</tr>
</table>
</form>
</body>
</html>
Przykład nr 3 - wysyłanie sms do wielu odbiorców przy wykorzystaniu biblioteki cURL.
<?php
$username = 'login';
$password = md5('haslo'); //lub $password='ciąg md5'
$from = urlencode('nazwa nadawcy');
$to = array('numer1','numer2');
$message = urlencode('Tresc wiadomosci');
echo send_sms($username,$password,$from,$to,$message);
function send_sms($username,$password,$from,$to,$message) {
$to_full = null;
foreach ($to as $k=>$v) $to_full.=$v.',';
$to_full = substr($to_full,0,-1);
$c = curl_init();
curl_setopt($c, CURLOPT_URL, 'http://api.smsapi.pl/send.do');
curl_setopt($c, CURLOPT_POST, 1);
curl_setopt($c, CURLOPT_SSL_VERIFYPEER,false);
curl_setopt($c, CURLOPT_POSTFIELDS, 'username='.$username.'&password='.$password.'&from='.$from.' &to='.$to_full.'&message='.$message);
curl_setopt($c, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($c, CURLOPT_USERAGENT, "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)");
curl_getinfo($c);
$result = curl_exec($c);
curl_close($c);
return $result;
}
?>
$username = 'login';
$password = md5('haslo'); //lub $password='ciąg md5'
$from = urlencode('nazwa nadawcy');
$to = array('numer1','numer2');
$message = urlencode('Tresc wiadomosci');
echo send_sms($username,$password,$from,$to,$message);
function send_sms($username,$password,$from,$to,$message) {
$to_full = null;
foreach ($to as $k=>$v) $to_full.=$v.',';
$to_full = substr($to_full,0,-1);
$c = curl_init();
curl_setopt($c, CURLOPT_URL, 'http://api.smsapi.pl/send.do');
curl_setopt($c, CURLOPT_POST, 1);
curl_setopt($c, CURLOPT_SSL_VERIFYPEER,false);
curl_setopt($c, CURLOPT_POSTFIELDS, 'username='.$username.'&password='.$password.'&from='.$from.' &to='.$to_full.'&message='.$message);
curl_setopt($c, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($c, CURLOPT_USERAGENT, "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)");
curl_getinfo($c);
$result = curl_exec($c);
curl_close($c);
return $result;
}
?>
3. Opis korzystania z usługi mailtosms.
Aby wysłać smsa za pomocą maila należy wysłać maila według schematu:
Przykład:
Dostępne parametry:
from= - pole nadawcy wiadomości
to= - adresat wiadomości
raport=1 - spowoduje odsyłanie maila z raportem czy udało się wysłać wiadomość (ID wiadomości lub numer błędu):
eco=1 - spowoduje wysłanie wiadomości ecoSMS"
message= - treść wiadmości, musi występować jako ostatni parametr!
Wiadomości mogą być wysyłane w kodowaniu: plain / quotedprintable / base64.
Ważne! Numer telefonu nie może zawierać znaku plus "+" na początku. Nazwa nadawcy (zmienna &from=) musi być aktywna. Treść wiadomość musi wystąpować jako ostatni parametr. Hasło należy podać w formie zaszyfrowanej algorytmem MD5!
ADRES: send.do@smsapi.pl
TEMAT: login@haslo(32_znaki_w_md5)
TREŚĆ: from=nadawca&to=numer&raport=(0/1)&eco=(0/1)&message=tresc wiadomści
TEMAT: login@haslo(32_znaki_w_md5)
TREŚĆ: from=nadawca&to=numer&raport=(0/1)&eco=(0/1)&message=tresc wiadomści
Przykład:
ADRES: send.do@smsapi.pl
TEMAT: login@8456fkty567gb3bg37b357b3457b3457
TREŚĆ: from=606606***&to=606605***&raport=1&eco=1&message=TEKST WIADOMOSCI
TEMAT: login@8456fkty567gb3bg37b357b3457b3457
TREŚĆ: from=606606***&to=606605***&raport=1&eco=1&message=TEKST WIADOMOSCI
Dostępne parametry:
from= - pole nadawcy wiadomości
to= - adresat wiadomości
raport=1 - spowoduje odsyłanie maila z raportem czy udało się wysłać wiadomość (ID wiadomości lub numer błędu):
eco=1 - spowoduje wysłanie wiadomości ecoSMS"
message= - treść wiadmości, musi występować jako ostatni parametr!
Wiadomości mogą być wysyłane w kodowaniu: plain / quotedprintable / base64.
Ważne! Numer telefonu nie może zawierać znaku plus "+" na początku. Nazwa nadawcy (zmienna &from=) musi być aktywna. Treść wiadomość musi wystąpować jako ostatni parametr. Hasło należy podać w formie zaszyfrowanej algorytmem MD5!
4. Wysyłanie wiadomości WAP PUSH.
Aby wysłać wiadomość WAP PUSH w zapytaniu należy użyć parametrów &udh=0605040b8423f0, &datacoding=bin a treść z linkiem zakodować do postaci binarnej.
W celu przekonwertowania treści do postaci binarnej należy użyć narzędzia dostępnego w zakładce Narzędzia.
Przykład:
Przykład:
uzytkownik&password=haslo&from=nazwa&to=48501000000
&udh=0605040b8423f0&datacoding=bin&message=860601ae02056a0045c60c037777772E736D73617069
2E706C000701035A61707261737A616D7920646F20736D734150492E706C000101
&udh=0605040b8423f0&datacoding=bin&message=860601ae02056a0045c60c037777772E736D73617069
2E706C000701035A61707261737A616D7920646F20736D734150492E706C000101
5. Wysyłanie wiadomości vCard.
Aby wysłać wiadomość vCard w zapytaniu należy użyć parametrów &udh=06050423F40000, &datacoding=bin a dane kontaktu zakodować do postaci binarnej.
W celu przekonwertowania treści do postaci binarnej należy użyć narzędzia dostępnego w zakładce Narzędzia.
Przykład:
Przykład:
uzytkownik&password=haslo&from=nazwa&to=48501000000
&udh=06050423F40000&datacoding=bin &message=424547494E3A56434152440D0A56455253494F4E3A322E310D0A464E3A736D7
3617069206D61736F776120777973796C6B610D0A4E3A6D61736F776120777973796C6B613B736D736170693
B3B3B0D0A54454C3B505245463B43454C4C3A3332373530353838390D0A454D41494C3B494E5445524E45543
A696E666F40736D736170692E706C0D0A55524C3A7777772E736D736170692E706C0D0A454E443A5643415244
&udh=06050423F40000&datacoding=bin &message=424547494E3A56434152440D0A56455253494F4E3A322E310D0A464E3A736D7
3617069206D61736F776120777973796C6B610D0A4E3A6D61736F776120777973796C6B613B736D736170693
B3B3B0D0A54454C3B505245463B43454C4C3A3332373530353838390D0A454D41494C3B494E5445524E45543
A696E666F40736D736170692E706C0D0A55524C3A7777772E736D736170692E706C0D0A454E443A5643415244
6. Wysyłanie wiadomości o określonej godzinie/dacie.
Aby wysłać wiadomość o określonej godzinie w zapytaniu należy użyć parametru &date=data, data powinna być podana w postaci timestamp.
W celu wygenerowania timestamp z podanego czasu należy użyć narzędzia dostępnego w zakładce Narzędzia.
Przykład:
Przykład:
http://api.smsapi.pl/send.do?username=uzytkownik&password=haslo&from=nazwa&to=48501000000
&date=1237383500&message=tresc wiadomosci
&date=1237383500&message=tresc wiadomosci










