Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Текущие адреса серверов для отправки запросов (в зависимости от того, где зарегистрирован пользователь):

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

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

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

Code Block
https://имя_хостаclk.prontosms.ru/sendsms.php

Пример:

Code Block
https://имя_хостаclk.prontosms.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&sadr=HLTelecom_от_кого_придет_СМС&dadr=номер_телефона_получателя_смс&text=текст%смс&translite=1

...

  • translite

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

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

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

...

Code Block
1178440060,1178440061

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

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

Code Block
https://имя_хостаclk.prontosms.ru/sendsms.php

Пример:

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

...

  • 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

Пример:

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

...

  • user – пользователь

  • pwd – пароль

  • smsid

    • ID SMS

  • detail

    • Запрос на детальную информацию по смс, всегда цифра 1

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

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

...

  • id_sms

    • номер SMS сообщения, полученный в ответном XML-документа в процессе отправки SMS сообщения.

  • time_change_state

    • время изменения статуса.

  • state_sms

    • статус сообщения:

    1. «send» - статус сообщения не получен. В этом случае передается пустой time_change_state.

    2. «not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем).

    3. «expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный Статус (не меняется со временем.

    4. «deliver» - сообщение доставлено. Конечный статус (не меняется со временем)

    5. «partly_deliver» - сообщение было отправлено, но статус так и не был получен. Конечный статус (не меняется со временем). В этом случае для разъяснения причин отсутствия статуса необходимо связаться со службой тех. поддержки.

  • num_parts

    • Количество частей в СМС.

  • price

    • Цена за одну часть СМС.

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

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

Code Block
https://имя_хостаclk.prontosms.ru/sendsms.php

Пример:

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

Входящие СМС

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

...

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

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

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

...