Общие вопросы с 9 до 19 МСК: +7 (499) 322-1627
Номер телефонаПароль Забыли? · Регистрация
Войти
Оглавление
sms/send
sms/mail
sms/status
sms/cost
my/balance
my/limit
my/senders
auth/get_token
auth/check
stoplist/add
stoplist/del
stoplist/get
ucs/sms
Описание метода:
Совершает отправку СМС сообщения одному или нескольким получателям.
Пример на HTTP:
http://sms.ru/sms/send?api_id=&to=&text=hello+world
Пример на curl для командной строки (UTF-8)
Пример на php (с включенным модулем curl)
Пример на php (без curl)
Пример на php (усиленная авторизация)
Пример на PERL (усиленная авторизация)
Примеры на Python
Адрес:
http://sms.ru/sms/send
Методы:
GET, POST
Параметры метода:
ПараметрОбязательныйОписание
toдаНомер телефона получателя (либо несколько номеров, через запятую — до 100 штук за один запрос)
textдаТекст сообщения в кодировке UTF-8
multiдаЕсли вы хотите в одном запросе отправить разные сообщения на несколько номеров, то воспользуйтесь этим параметром (до 100 сообщений за 1 запрос). В этом случае, параметры to и text использовать не нужно: каждое сообщение передается в виде multi[номер получателя]=текст&multi[номер получателя]=текст
Например: http://sms.ru/sms/send?api_id=&multi[]=hello+world&multi[другой номер]=world+not+hello
fromИмя отправителя (должно быть согласовано с администрацией). Если не заполнено, в качестве отправителя будет указан ваш номер.
timeЕсли вам нужна отложенная отправка, то укажите время отправки. Указывается в формате UNIX TIME (пример: 1280307978). Должно быть не больше 7 дней с момента подачи запроса. Если время меньше текущего времени, сообщение отправляется моментально.
translit=1Переводит все русские символы в латинские.
test=1Имитирует отправку сообщения для тестирования ваших программ на правильность обработки ответов сервера. При этом само сообщение не отправляется и баланс не расходуется.
partner_id=Если вы участвуете в партнерской программе, укажите этот параметр в запросе и получайте проценты от стоимости отправленных сообщений. Ваш уникальный идентификатор - - уже указан в параметре.
Параметры авторизации (выберите один способ):
ПараметрОбязательныйОписание
api_idда
Авторизацию по вашему уникальному ключу (api_id). Этот способ авторизации - самый удобный и приведен в примере выше.
для получения ключа зарегистрируйтесь на сайте
ПараметрОбязательныйОписание
loginдаВаш номер телефона (логин)
passwordдаПароль (в открытом виде, без шифрации)
ПараметрОбязательныйОписание
loginдаВаш номер телефона (логин)
tokenдаВременный токен, полученный через метод auth/get_token
sha512даsha512(пароль+token) - шифр, состоящий из пароля и токена, упакованные без пробелов в sha512
sha512 даsha512(пароль+token+api_id) - по вашему желанию вы можете усилить стойкость шифра, добавив ваш api_id (не рекомендуется)
Варианты ответа:
ОтветОписание
100Сообщение принято к отправке. На следующих строчках вы найдете идентификаторы отправленных сообщений в том же порядке, в котором вы указали номера, на которых совершалась отправка.
200Неправильный api_id
201Не хватает средств на лицевом счету
202Неправильно указан получатель
203Нет текста сообщения
204Имя отправителя не согласовано с администрацией
205Сообщение слишком длинное (превышает 8 СМС)
206Будет превышен или уже превышен дневной лимит на отправку сообщений
207На этот номер (или один из номеров) нельзя отправлять сообщения, либо указано более 100 номеров в списке получателей
208Параметр time указан неправильно
209Вы добавили этот номер (или один из номеров) в стоп-лист
210Используется GET, где необходимо использовать POST
211Метод не найден
212Текст сообщения необходимо передать в кодировке UTF-8 (вы передали в другой кодировке)
220Сервис временно недоступен, попробуйте чуть позже.
230Сообщение не принято к отправке, так как на один номер в день нельзя отправлять более 60 сообщений.
300Неправильный token (возможно истек срок действия, либо ваш IP изменился)
301Неправильный пароль, либо пользователь не найден
302Пользователь авторизован, но аккаунт не подтвержден (пользователь не ввел код, присланный в регистрационной смс)
+7 (499) 322-1627