SMSFox API


Интерфейс прикладного программирования (API) для интеграции smsfox.ru отправки СМС-сообщений в ваших проектах и сервисах. Для упрощения интеграции у нас есть библиотека на разных языках программирования, которая поможет реализовать отправку СМС одной командой.

Отправить СМС

Для отправки СМС нужно вызвать методом GET или POST адрес URL:

http://smsfox.ru/ru/api/?login=<login>&pwd=<pwd>&phones=<phones>&msg=<msg>

Пример использования:

<?php
$login = 'username';
$pwd = 'password';

$phones = '78901234567';
$msg = urlencode('I am text message');

$result = file_get_contents("http://smsfox.ru/ru/api/?
                      login=$login&pwd=$pwd&phones=$phones&msg=$msg");

if((int)$result == 1) {
    print 'Message successfully sent!';
} else {
    print 'Fail sent message.';
}
?>

Описание параметров передаваемых серверу:

Аргумент Описание
login Имя пользователя клиента
pwd Пароль клиента
phones Номер телефона или список номеров разделенные запятой или точкой с запятой. Номера должны быть в международном формате но без "+"
msg Текст отправляемого СМС. Максимальный размер - 800 символов. При необходимости будет разделено на несколько СМС, отправленных абоненту и оплаченных по отдельности. Размер одного SMS - 160 символов в латинице или 70 символов в кириллице.
Дополнительные опции
id ID сообщения. Используется для дальнейшей идентификации сообщения. Если не указывать, то будет назначен автоматически.
sender Имя отправителя, отображается в телефоне получателя. Разрешены английские буквы, цифры, пробел и некоторые символы. Все имена регистрируются в личном кабинете. Динамическое имя включается по запросу. Если этот параметр пуст, и не включена услуга "динамическое имя отправителя" то будет "SMSFox"

После получения и обработки данных, сервер возвращает Клиенту подтверждение с указанием результата обработки.

Сервер отправляет ответ в виде строки

Ответ Значение
01 Запрос успешно обработан
02 Ошибка в параметрах
03 Ошибка авторизации
04 Неверный формат номера телефона
05 Недостаточно поинтов на балансе Клиента
06 Сообщение запрещено
07 Сообщение на указанный номер не может быть доставлено

После обработки запроса сотовым оператором мы вызываем ваш скрипт обработчик и передаем статус сообщения.

Адрес обработчика, а также метод его вызова (POST или GET) указываются в профиле.

Параметры передаваемые на статус-обработчик:

Аргумент Описание
id ID сообщения
phone Номер телефона
status

Статус сообщения. Параметр в виде строки и может иметь значение (1, 2, 3 или 4):

01 - Сообщение успешно доставлено;
02 - Абонент не существует, заблокирован или не поддерживает СМС;
03 - Сообщение запрещено;
04 - Сообщение на указанный номер не может быть доставлено.

Статус обработчик вызывается для каждого номера телефона (отправленного СМС).

Для сообщений, которые отправляются через панель управления статус обработчик не вызывается.

Для отправки SMS-сообщения с вашего сайта вы можете использовать готовый скрипт из нашего архива.

PHP Python

✧ Рассылка СМС ✧ Интерфейс прикладного программирования (API)