Общие вопросы с 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
Описание метода:
Совершает отправку СМС сообщения одному или нескольким получателям.
Важно:
Если вы совершаете отправку кодов или паролей вашим пользователям, то чтобы не проходить длительное согласование ваших отправителей у сотовых операторов, вы можете воспользоваться упрощенным способом отправки. Для этого сообщение с кодом или паролем должно содержать только сам код или пароль без каких либо других слов ("Ваш код:", итд...). Сам код должен содержать от 3 до 9 цифр или латинских символов. (Пример: &text=132655). В этом случае код уйдет с наших отправителей, которые уже согласованы у всех операторов.
Пример на отправки обычного сообщения через HTTP:
http://sms.ru/sms/send?api_id=&to=&text=hello+world
Пример на отправки кода или пароля через HTTP (без необходимости согласования отправителя):
http://sms.ru/sms/send?api_id=&to=&text=132655
Пример на 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Превышен общий лимит количества сообщений на этот номер в день.
231Превышен лимит одинаковых сообщений на этот номер в минуту.
232Превышен лимит одинаковых сообщений на этот номер в день.
300Неправильный token (возможно истек срок действия, либо ваш IP изменился)
301Неправильный пароль, либо пользователь не найден
302Пользователь авторизован, но аккаунт не подтвержден (пользователь не ввел код, присланный в регистрационной смс)
+7 (499) 322-1627