Инструкция по работе с API

Отправка сообщения

URL: http://smsgate.astraliens.net/sms/send (так же поддерживается работа по защищенному HTTPS протоколу)
method: POST (рекомендуется) / GET (допускается)

Параметры, передаваемые в запросе:

login - логин в системе SMSGate [обязательно]
pass - пароль в системе SMSGate [обязательно]
sender - подпись отправителя, которая предварительно согласована с сервисом SMSGate (максимум 11 символов) [обязательно]
tel - номер телефона получателя в международном формате (например +380501234567) [обязательно]
txt - текст сообщения [обязательно]
flash - флаг Flash SMS (для отправки Flash-сообщений используйте flash=1) [опциональный]
translit - флаг транслитерации, принудительно включает транслитерацию отправляемого соообщения сервером SMSGate(используйте translit=1) [опциональный]
test - флаг тест (для отладки Ваших скриптов используйте test=1) [опциональный]

Ответ на запрос в формате JSON:

state - результат приёма сообщения сервером (true или false)
error - если во время приёма сообщения сервероv возникли ошибки, тексты ошибок будут содержаться в этом массиве
msg_id - уникальный ID сообщения внутри системы SMSGate

Примеры:

URL Request

http://smsgate.astraliens.net/sms/send?login=&pass=mY_SeCReT_pasSwOrD&sender=ASTRALiENS&tel=+380501234567&txt=test%20message%20from%20SMSGate

Пример использования API на языке программирования PHP

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'http://smsgate.astraliens.net/sms/send');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_POST, TRUE);
curl_setopt($curl, CURLOPT_FAILONERROR, 1);
curl_setopt($curl, CURLOPT_TIMEOUT, 15);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_POSTFIELDS,
array (
	'login'=>'',
	'pass'=>'mY_SeCReT_pasSwOrD',
	'sender'=>'MySender',
	'tel'=>'+380501234567',
	'txt'=>'My Text Message'
));
$result=json_decode(curl_exec($curl));

---

Получение статуса доставки сообщения

URL: http://smsgate.astraliens.net/api/sms/info (так же поддерживается работа по защищенному HTTPS протоколу)
method: POST (рекомендуется) / GET (допускается)

Параметры, передаваемые в запросе:

login - логин в системе SMSGate [обязательно]
pass - пароль в системе SMSGate [обязательно]
msg_id - номер сообщения в системе SMSGate, который был получен при отправке (при необходимости можно запросить одновременно до 50 сообщений через символ точки с запятой ;) [обязательно]

Ответ на запрос в формате JSON:

state - результат обработки запроса сервером (true или false)
error - если во время обработки запроса возникли ошибки или не были найдены запрашиваемые сообщения, тексты ошибок будут содержаться в этом массиве
msg - массив, содержащий данные об отправленных сообщениях

Содержимое массива msg
ID - номер сообщения в системе SMSGate
dt - дата получения сообщения сервером в формате unixtime
state - статус отправки сообщения (0 - в очереди, 1 - отправляется, 2 - отправлено, 3 - не доставлено)

Примеры:

URL Request

http://smsgate.astraliens.net/api/sms/info&login=&pass=mY_SeCReT_pasSwOrD&msg_id=23456;98765

Пример использования API на языке программирования PHP

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'http://smsgate.astraliens.net/api/sms/info');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_POST, TRUE);
curl_setopt($curl, CURLOPT_FAILONERROR, 1);
curl_setopt($curl, CURLOPT_TIMEOUT, 15);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_POSTFIELDS,
array (
	'login'=>'',
	'pass'=>'mY_SeCReT_pasSwOrD',
	'msg_id'=>'23456;98765',
));
$result=json_decode(curl_exec($curl));

---

Получение информации о состоянии аккаунта

URL: http://smsgate.astraliens.net/api/account/info (так же поддерживается работа по защищенному HTTPS протоколу)
method: POST (рекомендуется) / GET (допускается)

Параметры, передаваемые в запросе:

login - логин в системе SMSGate [обязательно]
pass - пароль в системе SMSGate [обязательно]

Ответ на запрос в формате JSON:

state - результат обработки запроса сервером (true или false)
error - если во время обработки запроса возникли ошибки или не были найдены запрашиваемые сообщения, тексты ошибок будут содержаться в этом массиве
account_info - массив, содержащий данные об аккаунте

Содержимое массива account_info
last_login - дата последнего входа в аккаунт через WEB-интерфейс в формате unixtime
cash - остаток средств на счету
plan - тарифный план
sms_left - остаток сообщений согласно тарифного плана (остаток указан на направления: Украина)

Примеры:

URL Request

http://smsgate.astraliens.net/api/account/info&login=&pass=mY_SeCReT_pasSwOrD

Пример использования API на языке программирования PHP

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'http://smsgate.astraliens.net/api/account/info');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_POST, TRUE);
curl_setopt($curl, CURLOPT_FAILONERROR, 1);
curl_setopt($curl, CURLOPT_TIMEOUT, 15);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($curl, CURLOPT_HEADER, 0);
curl_setopt($curl, CURLOPT_POSTFIELDS,
array (
	'login'=>'',
	'pass'=>'mY_SeCReT_pasSwOrD'
));
$result=json_decode(curl_exec($curl));