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» - сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой технической поддержки.

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

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