API позволяет рассылать сообщения через ваши проекты и сервисы по протоколам HTTP/HTTPS, SMTP и SMPP. Готовые библиотеки на разных языках программирования подключаются к вашему проекту и помогают отправлять сообщения из любого места с помощью одной команды. Для упрощенной авторизации вместо пары логин и пароль можно использовать специальный API-ключ.
Для проверки статуса доставки SMS используются методы get_status и get_status2.
В методе get_status2 имеется возможность добавления дополнительных параметров.
$client = new SoapClient ('https://smsc.kz/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
Идентификатор сообщения.
all
0 – (по умолчанию) получить статус сообщения в обычном формате.
1 – получить полную информацию об отправленном сообщении.
2 – добавить в информацию о сообщении данные об операторе и регионе абонента.
query
Строка дополнительных параметров (только в get_status2),
передаваемых в формате: 'параметр_1=значение_1&параметр_2=значение_2'.
Дата последнего изменения статуса. Формат 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
Сообщение не найдено.
4
IP-адрес временно заблокирован.
9
Попытка отправки более пяти запросов на получение статуса одного и того же сообщения в течение минуты.