/ База знаний

HTTP(s)

Используйте HTTP(s) протокол для массовой отправки СМС-сообщений

Наш сервис обеспечивает быструю доставку, гибкие настройки и подробную статистику. Интегрируйте СМС-рассылки в свои системы и повышайте эффективность коммуникации с клиентами.

Рассчитайте стоимость
Укажите количество номеров
5000
Стоимость, ₽
от 7500
Клиентов получите
~175
Попробовать бесплатно Стоимость сообщения зависит от многих параметров
После регистрации будет начислено 100 рублей для тестов

РУКОВОДСТВО ПО ВЗАИМОДЕЙСТВИЮ С СЕРВИСОМ КОРОТКИХ СООБЩЕНИЙ (SMS) НА ОСНОВЕ HTTPS ПРОТОКОЛА, МЕТОДОМ GET

Руководство в PDF

Содержание:

1. Общие положения

  • Запрос необходимо отправлять в UTF-8 кодировке, в переменной xml.
  • Не рекомендуется использовать URL длиной более 2000 символов.
  • Одинаковые запросы можно отправлять не чаще 1 раза в 1 минуту. В случае ошибки вернется: error: Попытка отправки более одного одинакового запроса в течение минуты

2. Отправка SMS

2.1. Запрос на отправку SMS

Отправляется GET-запрос по адресу https://sms.targetsms.ru/sendsms.php

Запрос необходимо отправлять в UTF-8 кодировке, в переменной xml.

Пример:

https://sms.targetsms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&name_delivery=название_рассылки&sadr=от_кого_придет_SMS&dadr=номер_телефона_получателя_SMS&text=текст SMS

Переменные:

  • user - Ваш логин в нашей системе;
  • pwd - Ваш пароль в нашей системе;
  • name_delivery - название рассылки для детальной статистики личного кабинета (не обязательный параметр; по умолчанию - Шлюз Get)
  • sadr - Адрес отправителя (до 11 латинских букв или цифр включительно);
  • text - Текст SMS;
  • dadr - Номер телефона получателя в формате 79001234567 (можно несколько телефонов через запятую)

2.2. В случае успешной отправки смс

Возвращается ID SMS в plainText.

Пример:

1179038981

В случае отправки на несколько номеров возвращается ID SMS через запятую в plainText.

Пример:

1178440060,1178440061

2.3. В случае ошибки

В случае возникновения ошибки возвращается текст ошибки в plainText. Возможные варианты:

  • У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером.
  • Закончились SMS.
  • Аккаунт заблокирован.
  • Укажите номер телефона.
  • Номер телефона присутствует в стоп-листе.
  • Данное направление закрыто для вас.
  • Данное направление закрыто.
  • Недостаточно средств для отправки SMS. SMS будет отправлена как только вы пополните счет по данному направлению.
  • Текст SMS отклонен модератором.
  • Нет отправителя.
  • Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых.
  • Номер телефона должен быть меньше 15 символов.
  • Нет текста сообщения.
  • Нет ссылки.
  • Такого отправителя Нет.
  • Отправитель не прошел модерацию.
  • error: Попытка отправки более одного одинакового запроса в течение минуты

3. Проверка статуса SMS

3.1. Запрос

Отправляется GET-запрос по адресу https://sms.targetsms.ru/sendsms.php

Запрос необходимо отправлять в UTF-8 кодировке, в переменной xml.

Пример:

https://sms.targetsms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&smsid=id_sms

Переменные:

  • user - Ваш логин в нашей системе;
  • pwd - Ваш пароль в нашей системе;
  • smsid - ID SMS.

3.2. В случае успешного запроса

В случае успешного запроса возвращается статус SMS сообщения в plainText:

  • send - статус сообщения не получен.
  • not_deliver - сообщение не было доставлено. Конечный статус (не меняется со временем).
  • expired - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный статус (не меняется со временем).
  • deliver - сообщение доставлено. Конечный статус (не меняется со временем)
  • partly_deliver - сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой тех. поддержки.

Пример:

deliver

3.3. В случае ошибки

В случае возникновения ошибки возвращается текст ошибки в plainText. Возможные варианты:

  • У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером.
  • Закончились SMS.
  • Аккаунт заблокирован.
  • Укажите номер телефона.
  • Номер телефона присутствует в стоп-листе.
  • Данное направление закрыто для вас.
  • Данное направление закрыто.
  • Недостаточно средств для отправки SMS. SMS будет отправлена как только вы пополните счет по данному направлению.
  • Текст SMS отклонен модератором.
  • Нет отправителя.
  • Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых.
  • Номер телефона должен быть меньше 15 символов.
  • Нет текста сообщения.
  • Нет ссылки.
  • Такого отправителя Нет.
  • Отправитель не прошел модерацию.
  • error: Попытка отправки более одного одинакового запроса в течение минуты

4. Проверка статуса SMS с подробной информацией

4.1. Запрос

Отправляется GET-запрос по адресу https://sms.targetsms.ru/sendsms.php

Запрос необходимо отправлять в UTF-8 кодировке, в переменной xml.

Пример:

https://sms.targetsms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&smsid=id_sms&detail=1

Переменные:

  • user - Ваш логин в нашей системе;
  • pwd - Ваш пароль в нашей системе;
  • smsid - ID SMS;
  • detail - параметр, определяющий вывод подробной информации (цифра 1)

4.2. В случае успешного запроса

В случае успешного запроса возвращается статус SMS-сообщения в формате plainText. Строка является массивом, обработанной через php функцию serialize(). Для обратного перевода строки в массив, необходимо использовать php функцию unserialize():

Пример массива ответа, полученный через функцию unserialize():

Array (
[id_sms] => IDSMS в системе для проверки статуса
[time_change_state] => 2011-01-01 12:57:46
[state_sms] => Статус
[num_parts] => 2
[price] => 1.15
)

Где:

  • id_sms - номер SMS сообщения, полученный в ответном XML-документе в процессе отправки SMS сообщения.
  • time_change_state - время изменения статуса.
  • state_sms - статус сообщения:
    • «send» - статус сообщения не получен. В этом случае передается пустой time_change_state.
    • «not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).
    • «expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный статус (не меняется со временем).
    • «deliver» - сообщение доставлено. Конечный статус (не меняется со временем)
    • «partly_deliver» - сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой тех. поддержки.
  • num_parts - Количество частей в СМС.
  • price - Цена за одну часть СМС.

4.3. В случае ошибки

В случае возникновения ошибки возвращается текст ошибки в plainText. Возможные варианты:

  • У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером.
  • Закончились SMS.
  • Аккаунт заблокирован.
  • Укажите номер телефона.
  • Номер телефона присутствует в стоп-листе.
  • Данное направление закрыто для вас.
  • Данное направление закрыто.
  • Недостаточно средств для отправки SMS. SMS будет отправлена как только вы пополните счет по данному направлению.
  • Текст SMS отклонен модератором.
  • Нет отправителя.
  • Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых.
  • Номер телефона должен быть меньше 15 символов.
  • Нет текста сообщения.
  • Нет ссылки.
  • Такого отправителя Нет.
  • Отправитель не прошел модерацию.
  • error: Попытка отправки более одного одинакового запроса в течение минуты

5. Проверка баланса

5.1. Запрос

Отправляется GET-запрос по адресу: https://sms.targetsms.ru/sendsms.php

Пример:

https://sms.targetsms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&balance=1

Переменные:

  • user - Ваш логин в нашей системе;
  • pwd - Ваш пароль в нашей системе;
  • balance - параметр, определяющий вывод баланса (цифра 1)

5.2. В случае успешного запроса

В случае успешного запроса в plainText возвращается ваш текущий баланс и остаток по текущему пакету через запятую. Пример ответа:

445.6 RUR

Россия:361,MTC:1,Мегафон:1,Skylink:1,Yota:1,Байкалвестком:1,Уралсвязьинформ:1,Енисейтелеком:1,НСС:1,Мотив:1,Tele2:1,CMAPTC:1,Ростелеком:1,BeeLine:1,Остальные:1

5.3. В случае ошибки

В случае возникновения ошибки возвращается текст ошибки в plainText. Возможные варианты:

  • У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером.
  • Закончились SMS.
  • Аккаунт заблокирован.
  • Укажите номер телефона.
  • Номер телефона присутствует в стоп-листе.
  • Данное направление закрыто для вас.
  • Данное направление закрыто.
  • Недостаточно средств для отправки SMS. SMS будет отправлена как только вы пополните счет по данному направлению.
  • Текст SMS отклонен модератором.
  • Нет отправителя.
  • Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых.
  • Номер телефона должен быть меньше 15 символов.
  • Нет текста сообщения.
  • Нет ссылки.
  • Такого отправителя Нет.
  • Отправитель не прошел модерацию.
  • error: Попытка отправки более одного одинакового запроса в течение минуты
Остались вопросы? Свяжемся с вами и всё расскажем!
Выберите способ, как с вами связаться
Отправить
Через что можно законнектиться
Библиотека API-интеграций
Начните отправлять СМС уже сегодня!
100 рублей уже будут на балансе после регистрации
Попробовать бесплатно

Возврат к списку