...
id_sms
номер SMS сообщения, полученный в ответном XML-документа в процессе отправки SMS сообщения.
time_change_state
время изменения статуса.
state_sms
статус сообщения:
«send» - статус сообщения не получен. В этом случае передается пустой time_change_state.
«not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).
«expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный Статус (не меняется со временем.
«deliver» - сообщение доставлено. Конечный статус (не меняется со временем)
«partly_deliver» - сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой тех. поддержки.
num_parts
Количество частей в СМС.
price
Цена за одну часть СМС.
...
Code Block |
---|
445.6 RUR Россия:361,МТС:1,Мегафон:1,Skylink:1,Yota:1,Байкалвестком:1,Уралсвязьинформ:1,Енисейтелеком:1,НСС:1,Мотив:1,Tele2:1,СМАРТС:1,Ростелеком:1,BeeLine:1,Остальные:1 |
Ошибки возвращаемые платформой:
В случае возникновения ошибки возвращается текст ошибки в plainText. Возможные варианты:
Закончились SMS/Недостаточно средств для отправки SMS;
Аккаунт заблокирован;
Укажите номер телефона;
Номер телефона присутствует в стоп-листе;
Данное направление закрыто для вас;
Нет отправителя;
Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых;
Номер телефона должен быть меньше 15 символов.;
Нет текста сообщения;
Отправитель не прошел модерацию;
Попытка отправки более одного одинакового запроса в течение минуты;
Данное сообщение уже было отправлено.
В случае возникновения ошибки свяжитесь со службой технической поддержки.
Входящие СМС:
Имеется возможность принимать входящие СМС, в том числе и с коротких номеров. Для подключения сервиса, использующего короткий номер, необходимо:
Отправить заявку, на подключение входящих смс.
Предоставить адрес URL скрипта обработчика на вашем сайте.
API использует GET запрос для передачи сообщения, которое абонент отправил на короткий номер с предоставленным вам префиксом. Кроме самого текста сообщения, вашему скрипту будут переданы, другие данные, которые вы можете использовать для обработки "входных данных" у себя на сайте. Существует 2 способа оповещения пользователя:
Способ 1. Асинхронное оповещение
Запрос к Вашу скрипту выглядит так:
Code Block |
---|
http://адрес_сервера/ваш_скрипт?date=2014-05-28 05:38:15&prefix=0001&text=test_sms&smsid=543&sender=3443&receiver=9102844715 |
Переменные:
date - дата обработки смс на короткий номер в формате
20012020-02-
0323 01:02:03
prefix - префикс. Текст, который необходимо отправить Абоненту в смс-сообщении (вначале), чтобы сообщение было однозначно идентифицировано нашей системой и отнесено к Вашему Проекту.
text - текст входящего сообщения. Обратите внимание, текст приходит в кодировке utf-8.
smsid - уникальный идентификатор СМС в системе.
sender - номер телефона абонента приславшего смс.
receiver - короткий номер, на который пришла входящая
смс.receiver
номер телефона абонента приславшегосмс.
После обработки "входных данных" ваш скрипт должен ответить HTTP статусом 200 с текстом телом ответа smsid=543 5543 (Уникальный идентификатор СМС). В противном случае наша система будет пытаться доставить сообщение снова и снова (увеличивая интервал между попытками).
Ошибки возвращаемые платформой:
В случае возникновения ошибки возвращается текст ошибки в plainText. Возможные варианты:
Закончились SMS/Недостаточно средств для отправки SMS;
Аккаунт заблокирован;
Укажите номер телефона;
Номер телефона присутствует в стоп-листе;
Данное направление закрыто для вас;
Нет отправителя;
Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых;
Номер телефона должен быть меньше 15 символов.;
Нет текста сообщения;
Отправитель не прошел модерацию;
Попытка отправки более одного одинакового запроса в течение минуты;
Данное сообщение уже было отправлено.
В случае возникновения ошибки свяжитесь со службой технической поддержки
Способ 2. Синхронное оповещение, с получением текста ответного смс
Запрос к Вашу скрипту выглядит так:
Code Block |
---|
http://адрес_сервера/ваш_скрипт?date=2020-02-23 01:02:03&prefix=0001&text=test_sms&smsid=543&sender=3443&receiver=79001234567
|
Переменные:
date - дата обработки смс на короткий номер в формате 2020-02-23 01:02:03
prefix - префикс. Текст, который необходимо отправить Абоненту в смс-сообщении (вначале), чтобы сообщение было однозначно идентифицировано нашей системой и отнесено к Вашему Проекту.
text - текст входящего сообщения. Обратите внимание, текст приходит в кодировке utf-8.
smsid - уникальный идентификатор СМС в системе.
sender - номер телефона абонента приславшего смс.
receiver - короткий номер, на который пришла входящая смс.
В ответ мы ожидаем от вашего скрипта текст ответного смс, помещенного в тело ответа. В случае, если текст ответного смс не нужен, тело ответа должно быть пустым.