Интеграция с сервисом (API)

API позволяет рассылать сообщения через ваши проекты и сервисы по протоколам HTTP/HTTPS, SMTP и SMPP. Готовые библиотеки на разных языках программирования подключаются к вашему проекту и помогают отправлять сообщения из любого места с помощью одной команды. Для упрощенной авторизации вместо пары логин и пароль можно использовать специальный API-ключ.


HTTP/HTTPS SMTP SMPP SOAP OMS SMS-команды Библиотеки и примеры кода

Проверка статуса

Для проверки статуса доставки SMS используются методы get_status и get_status2.
В методе get_status2 имеется возможность добавления дополнительных параметров.

$client = new SoapClient ('https://smsc.ru/sys/soap.php?wsdl');
$ret = $client->get_status(array('login'=>'alex', 'psw'=>'123', 'phone'=>'79999999999', 'id'=>'999', 'all'=>'0'));

Серверу передаются следующие параметры:

ПараметрЗначение
loginЛогин Клиента.
pswПароль Клиента (можно добавить или изменить на данной странице).
apikeyСпециальный API-ключ, используемый для упрощенной авторизации вместо пары "логин+пароль" (можно создать на данной странице).
phoneНомер телефона.
idИдентификатор сообщения.
all0 – (по умолчанию) получить статус сообщения в обычном формате.
1 – получить полную информацию об отправленном сообщении.
2 – добавить в информацию о сообщении данные об операторе и регионе абонента.
queryСтрока дополнительных параметров (только в get_status2), передаваемых в формате: 'параметр_1=значение_1&параметр_2=значение_2'.

Возвращаемые параметры:

ПараметрЗначение
statusКод статуса (список).
last_dateДата последнего изменения статуса. Формат DD.MM.YYYY hh:mm:ss.
errКод ошибки, если сообщение не может быть доставлено (список).
errorКод ошибки, если статус не может быть запрошен.
all = 1
send_dateДата отправки сообщения (формат DD.MM.YYYY hh:mm:ss).
phoneНомер телефона абонента.
costСтоимость сообщения.
sender_idИмя отправителя.
status_nameНазвание статуса.
messageТекст сообщения.
sms_cntКоличество частей в SMS-сообщении (либо секунд в голосовом сообщении).
all = 2
operatorНазвание оператора абонента.
regionРегион регистрации номера абонента.

Код ошибки (error) может принимать следующие значения:

ЗначениеОписание
1Ошибка в параметрах.
2Неверный логин или пароль. Также возникает при попытке отправки сообщения с IP-адреса, не входящего в список разрешенных Клиентом (если такой список был настроен Клиентом ранее).
3Сообщение не найдено.
4IP-адрес временно заблокирован.
9Попытка отправки более пяти запросов на получение статуса одного и того же сообщения в течение минуты.