Руководство по взаимодействию с сервисом коротких сообщений (SMS) на основе HTTPS протокола, методом GET.

Запросы необходимо отправлять в UTF-8 кодировке. Не стоит использовать URL длиной более 2,000 символов. Но этот параметр зависит от многих факторов и может различаться в большую или меньшую сторону. Одинаковые запросы можно отправлять не чаще 1 раза в 1 минуту. В случае ошибки вернется:

Code Block
error: Попытка отправки более одного одинакового запроса в течение минуты

Запрос на отправку смс:

Отправляется GET-запрос по адресу:

...

translite
- транслитерация текста СМС с кириллицы на латиницу (не обязательный параметр). Для транслитерации данный параметр должен быть равен 1.

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

Возвращается ID SMS в plainText. Пример:

...

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

Code Block
1178440060,1178440061

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

Отправляетя Отправляется GET-запрос по адресу:

Code Block
https://clk.prontosms.ru/sendsms.php

...

user – пользователь
pwd – пароль
smsid
- ID SMS

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

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

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

Пример:

Code Block
deliver

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

Отправляетя Отправляется GET-запрос по адресу:

Code Block
https://clk.prontosms.ru/sendsms.php

...

user – пользователь
pwd – пароль
smsid
- ID SMS
detail
- Запрос на детальную информацию по смс, всегда цифра 1

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

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

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

Code Block

language	php

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
1. статус сообщения:
2. «send» - статус сообщения не получен. В этом случае передается пустой time_change_state.
3. «not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).
4. «expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный Статус (не меняется со временем.
5. «deliver» - сообщение доставлено. Конечный статус (не меняется со временем)
6. «partly_deliver» - сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой тех. поддержки.
num_parts
- Количество частей в СМС.
price
- Цена за одну часть СМС.

Проверка баланса:

Отправляется GET-запрос по адресу:

...

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

Переменные: user – пользователь pwd – пароль * balance – параметр, определяющий вывод баланса (цифра 1)

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

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

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 символов.;
Нет текста сообщения;
Отправитель не прошел модерацию;
Попытка отправки более одного одинакового запроса в течение минуты;
Данное сообщение уже было отправлено.

В случае возникновения ошибки свяжитесь со службой технической поддержки.

Входящие СМС:

Имеется возможность принимать входящие СМС, в том числе и с коротких номеров. Для подключения сервиса, использующего короткий номер, необходимо:

...

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 - дата обработки смс на короткий номер в формате
2001
2020-02-
03
23 01:02:03
prefix - префикс. Текст, который необходимо отправить Абоненту в смс-сообщении (вначале), чтобы сообщение было однозначно идентифицировано нашей системой и отнесено к Вашему Проекту.
text - текст входящего сообщения. Обратите внимание, текст приходит в кодировке utf-8.
smsid - уникальный идентификатор СМС в системе.
sender - номер телефона абонента приславшего смс.
receiver - короткий номер, на который пришла входящая смс.
receiver
- номер телефона абонента приславшего смс.

После обработки "входных данных" ваш скрипт должен ответить HTTP статусом 200 с текстом телом ответа smsid=543 5543 (Уникальный идентификатор СМС). В противном случае наша система будет пытаться доставить сообщение снова и снова (увеличивая интервал между попытками).

Ошибки возвращаемые платформой

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

...

У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером.

...

Закончились SMS.

...

Аккаунт заблокирован.

...

Укажите номер телефона.

...

Номер телефона присутствует в стоп-листе.

...

Данное направление закрыто для вас.

...

Данное направление закрыто.

...

Недостаточно средств для отправки SMS. SMS будет отправлена как только вы пополните счет по данному направлению.

...

Текст SMS отклонен модератором.

...

Нет отправителя.

...

Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых.

...

Номер телефона должен быть меньше 15 символов.

...

Нет текста сообщения.

...

Нет ссылки.

...

Такого отправителя Нет.

...

Отправитель не прошел модерацию.

...

error: Попытка отправки более одного одинакового запроса в течение минуты

Способ 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 - короткий номер, на который пришла входящая смс.

В ответ мы ожидаем от вашего скрипта текст ответного смс, помещенного в тело ответа. В случае, если текст ответного смс не нужен, тело ответа должно быть пустым.

...

Page tree

Versions Compared

Old Version 3

New Version Current

Key

Запрос на отправку смс:

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

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

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

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

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

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

Проверка баланса:

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

Ошибки возвращаемые платформой:

Входящие СМС:

Способ 1. Асинхронное оповещение

Ошибки возвращаемые платформой

Способ 2. Синхронное оповещение, с получением текста ответного смс

Page tree

Page History

Versions Compared

Old Version 3

New Version Current

Key

Запрос на отправку смс:

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

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

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

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

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

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

Проверка баланса:

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

Ошибки возвращаемые платформой:

Входящие СМС:

Способ 1. Асинхронное оповещение

Ошибки возвращаемые платформой

Способ 2. Синхронное оповещение, с получением текста ответного смс