Versions Compared

Key

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

Для управления используются следующие запросы:

addsms - создание или редактирование уведомления по SMS. Дополнительные параметры:

  • k - идентификатор сессии пользователя;
  • id - идентификатор уведомления по SMS,  если идентификатор отсутствует - создается новое уведомление, иначе - редактируется существующее;

  • name - имя уведомления по SMS, длина не более 63 символов;
  • to_phone - номер получателя, номеров может быть несколько, тогда они разделяются через знак запятой, возможно не более 10 номеров длиной не более 31 символа каждый;
  • message - шаблон текста сообщения, длина не более 511 символов.


При успешном создании нового элемента, ответ содержит идентификатор элемента, и имеет вид: 

<error type="no error" id="603001" />

При создании нового уведомления (id не указывается), все перечисленные параметры являются обязательными. При изменении допускается указывать только модифицируемые параметры. Пустые параметры не допускаются.


delsms - удаление уведомления по SMS. Обязательные параметры:

  • k - идентификатор сессии пользователя;
  • id - идентификатор уведомления по SMS.

send_sms_message - отправка тестового сообщения, при этом не создается новый элемент. Обязательные параметры:

  • k - идентификатор сессии пользователя, длина не более 63 символов;
  • to_phone - номер получателя, номеров может быть несколько, тогда они разделяются через знак запятой, возможно не более 10 номеров длиной не более 31 символа каждый;

  • message - шаблон текста сообщения, длина не более 511 символов.

getelement - чтение элемента. Обязательные параметры:

  • k - идентификатор сессии пользователя;
  • id - идентификатор элемента.

Ответ содержит информацию об элементе:

<element id="603001" module ="2003" num="1" clas="notifier" type="sms" name="my_smsko" state="off" to_phone="85551112233,87771234567" message="Logic %4, System time: %3" />









The following queries are used for management:

addsms - create or edit a notification by SMS. Extra options:

  • k is the user session ID;
  • id - identifier of the SMS notification, if there is no identifier - a new notification is created, otherwise - the existing notification is edited;
  • name - the name of the SMS notification, the length is not more than 63 characters;
  • to_phone - the number of the recipient, the numbers can be several, then they are separated by a comma, maybe not more than 10 numbers with a maximum of 31 characters each;
  • message - message text template, the length is not more than 511 characters.


If a new element is successfully created, the response contains the element identifier, and looks like:

<error type="no error" id="603001" />

When creating a new notification (id is not specified), all the listed parameters are mandatory. When changing, only modifiable parameters can be specified. Empty parameters are not allowed.


delsms - delete the notification by SMS. Required parameters:

  • k is the user session ID;
  • id is the SMS notification ID.

send_sms_message - send a test message, without creating a new element. Required parameters:

  • k is the user session ID, the length is not more than 63 characters;
  • to_phone - the number of the recipient, the numbers can be several, then they are separated by a comma, maybe not more than 10 numbers with a maximum of 31 characters each;
  • message - message text template, the length is not more than 511 characters.

getelement - read the element. Required parameters:

  • k is the user session ID;
  • id is the ID of the item.

The answer contains information about the element:


<element id="603001" module ="2003" num="1" clas="notifier" type="sms" name="my_smsko" state="off" to_phone="85551112233,87771234567" message="Logic %4, System time: %3" />