Zaufali nam:

Spis treści
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)


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.
<?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;
}

?>

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>

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;
}

?>

3. Opis korzystania z usługi mailtosms.
Aby wysłać smsa za pomocą maila należy wysłać maila według schematu:

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

Przykład:
ADRES: send.do@smsapi.pl
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:
uzytkownik&password=haslo&from=nazwa&to=48501000000
&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:
uzytkownik&password=haslo&from=nazwa&to=48501000000
&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:
http://api.smsapi.pl/send.do?username=uzytkownik&password=haslo&from=nazwa&to=48501000000
&date=1237383500&message=tresc wiadomosci