Вход в личный кабинет
Вход в личный кабинет
Отправка одиночных SMS. API PLAIN

Запрос для отправки одиночного SMS


Параметры запроса →
Ответ в случае успешной обработки запроса →

Параметры запроса

чёрный — обязательные параметры
серый — необязательные параметры
URL
https://userarea.sms-assistent.by/api/v1/send_sms/plain
Пример GET запроса

https://userarea.sms-assistent.by/api/v1/send_sms/plain?user=ваш_логин&password=пароль_для_API&recipient=ХХХХХХХХХ&message=текст_смс&sender=отправитель
Описание тегов в запросе
user
ваш логин, для доступа в Личный кабинет (ЛК)
password
ваш пароль к API, который генерируется на странице «SMS-рассылка» — «Рассылка по API»
recipient
номер получателя (в возможном формате)
message
текст SMS
sender
отправитель SMS (подпись SMS)
date_send
дата отправки SMS (передается только в том случае, если необходимо отправить запланированную рассылку).
Формат: ГГГГММДДЧЧММ. Например, передаем значение 201612250159 для того, чтобы запланировать рассылку на 25 декабря 2016 г. на 1ч 59 м.
Дата запланированной рассылки должна быть не меньше, чем текущая дата +10 минут
validity_period
срок жизни SMS в часах, значения >48 часов не обрабатываются (в этом случае выставляется значение равное 48).

Мы можем установить целиком для вашего аккаунта выбранное вами время жизни SMS. При этом все SMS, отправляемые по API PLAIN, будут иметь это установленное время жизни. Для этого сделайте запрос на e-mail службы технической поддержки с e-mail, закреплённого за вашим аккаунтом

Происходят следующие проверки:
  • значение параметра в диапазоне от 1 до 48 воспринимается как часы;
  • значение параметра в диапазоне от 49 до 3600 воспринимается как ошибочное, по умолчанию присваивается 48 ч;
  • в диапазоне от 3600 до 172800 воспринимается как передача данных в секундах;
  • значение больше, чем 172800, воспринимается как ошибочное и выставляется по умолчанию 48 ч.
name
наименование, которое необходимо присвоить рассылке. По наименованию в последующем можно фильтровать рассылки в разделе «Отправленные».
webhook_url
адрес (URL) вашего сайта, на который будет отправлен отчёт о доставке SMS после того, как статус доставки у этого SMS поменяется.
Подробнее по формату отчёта о доставке см. здесь.
Ответ в случае успешной обработки запроса
возвращается код результата выполнения операции
Ещё в этом разделе

Отправка одиночных SMS
API PLAIN
Основные правила
Отправка одиночных SMS. API PLAIN
Получение статуса доставки SMS
Отправка одиночных SMS. API PLAIN
Запрос остатка средств на балансе
Отправка одиночных SMS. API PLAIN
Получение списка доступных имён отправителей из аккаунта
Отправка одиночных SMS. API PLAIN
Получение списка доступных шаблонов SMS из аккаунта