HTTP-запрос методом GET
Руководство по взаимодействию с сервисом на основе HTTPS протокола методом GET.
Запросы необходимо отправлять в UTF-8 кодировке. Не стоит использовать URL длиной более 2,000 символов. Но этот параметр зависит от многих факторов и может различаться в большую или меньшую сторону.
Данные отправляются на адрес:
https://clk2.prontosms.ru/sendsms.php
методом GET.
Для отправки SMS сообщений:
Используются следующие переменные:
user - пользователь
pwd - пароль
sadr - отправитель SMS. Именно это значение будет выводиться на телефоне абонента в поле от кого SMS;
text - текст смс;
dadr - номер абонента, которому адресована SMS. Можно несколько телефонов через запятую. Номера в международном формате, например:
79000000001 (для России);
380442589632 (для Украины);
Пример запроса:
https://clk2.prontosms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&sadr=от_кого_придет_СМС&dadr=номер_телефона_получателя_смс&text=текст смс
Для отправки Viber сообщений:
Используются следующие переменные:
user - пользователь
pwd - пароль
sender_viber – отправитель Viber сообщения
dadr - номер абонента, которому адресована SMS. Можно несколько телефонов через запятую. Номера в международном формате, например:
79000000001 (для России);
380442589632 (для Украины);
text_viber - текст Viber сообщения
button_viber - текст кнопки Viber сообщения
action_viber - ссылка для кнопки Viber сообщения
image_viber - адрес картинки для Viber сообщения
Пример запроса:
https://clk2.prontosms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&sender_viber=от_кого_придет_сообщение&dadr=номер_телефона_получателя_смс&text_viber=текст_Viber_сообщения&button_viber=текст_кнопки_Viber_сообщения&action_viber=ссылка_для_кнопки_Viber_сообщения&image_viber=http://адрес_картинки_для_Viber_сообщения
В случае успешной отправки сообщения:
Возвращается ID SMS в plainText. Пример:
В случае отправки на несколько номеров возвращается ID SMS через запятую в plaintText. Пример:
В случае не успешной отправки сообщения:
Возвращается текст ошибки в plainText.
Возможные варианты:
phone_code_user - закончились SMS/данное направление закрыто;
block - аккаунт заблокирован;
Укажите номер телефона;
stop_phone - номер телефона присутствует в стоп-листе;
wrong_auth - неверный логин или пароль;
incorrect_originator - отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых;
incorrect_phone - номер телефона должен быть меньше 15 символов;
no_text_sms - нет текста сообщения;
not_registr_originator - такого отправителя нет/отправитель не прошел модерацию.
В случае возникновения ошибки свяжитесь со службой технической поддержки
Для проверки статуса сообщения:
Используются следующие переменные:
user - пользователь
pwd - пароль
smsid - ID SMS
Пример запроса:
В случае успешной отправки запроса:
В случае успешной отправки запроса на получение статуса сообщения возвращается статус сообщения в plainText:
«send» - статус сообщения еще не получен.
«not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).
«expired» - абонент находился не в сети в те моменты, когда производились попытки доставки. Конечный статус (не меняется со временем).
«deliver» - сообщение доставлено. Конечный статус (не меняется со временем).
«partly_deliver» - сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой технической поддержки.
В случае не успешной отправки запроса:
Возвращается пустой ответ сервера. Проверьте корректность указанных данных и попробуйте еще раз, либо свяжитесь со службой технической поддержки.