Page Comparison

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

addmail - создание или редактирование уведомления по электронной почте. Дополнительные параметры:

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

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

• name - имя уведомления по электронной почте (передается в теме сообщения), длина не более 63 символов;
• server - SMTP сервер, длина не более 127 символов;
• port - порт службы SMTP на сервере;
• ssl_active - SSL при обмене с почтовым сервером, true или false;
• starttls - true или false;
• login - имя учетной записи на сервере, длина не более 63 символов;
• password - пароль учетной записи на сервере, длина не более 63 символов;
• from - адрес отправителя, длина не более 63 символов;
• to - адрес получателя, возможно не более 10 адресов длиной не более 63 символов каждый;
• message - шаблон текста сообщения, длина не более 1023 символов.

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

delmail - удаление уведомления по электронной почте. Обязательные параметры:

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

• id - идентификатор уведомления по электронной почте.
  
  

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

• k - идентификатор сессии пользователя;
• type - тип тестового уведомления (mail);
• server - SMTP сервер, длина не более 127 символов;
• port - порт службы SMTP на сервере;
• ssl_active - SSL при обмене с почтовым сервером, true или false;
• starttls - true или false;
• login - имя учетной записи на сервере, длина не более 63 символов;
• password - пароль учетной записи на сервере, длина не более 63 символов;
• from - адрес отправителя, длина не более 63 символов;
• to - адрес получателя, возможно не более 10 адресов длиной не более 63 символов каждый;
• message - шаблон текста сообщения, длина не более 1023 символов.

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

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

• id - идентификатор элемента.

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

<element id="601001" module ="2002" num="1" clas="notifier" type="mailer" name="my_mail" state="off" server="smtp.mail.com" port="465" 
ssl_active="true" starttls="false" login="myself" password="mypass333" to="grandma@mail.kz,grandpa@mail.kz" from="myself@mail.com" 
message="Logic %4:\n--\nDefinition:\n%1\nCurrent sensor state:\n%2\n--\nSystem time: %3" />

The following queries are used for management:

addmail - create or edit an email notification. Extra options:

• k is the user session ID;
• id - the identifier of the notification by e-mail, if the identifier is absent - a new notification is created, otherwise - the existing notification is edited;
• name - the name of the notification by e-mail (transmitted in the message subject), the length is not more than 63 characters;
• server - SMTP server, the length is not more than 127 characters;
• port - the SMTP service port on the server;
• ssl_active - SSL when communicating with the mail server, true or false;
• starttls - true or false;
• login - the name of the account on the server, the length is not more than 63 characters;
• password - the password of the account on the server, the length is not more than 63 characters;
• from - the address of the sender, the length is not more than 63 characters;
• to - the address of the recipient, not more than 10 addresses with a maximum length of 63 characters each;
• message - message text template, the length is not more than 1023 characters.

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

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.

delmail - delete the notification by e-mail. Required parameters:

• k is the user session ID;
• id is the identifier of the notification by e-mail.

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

• k is the user session ID;
• type - type of test notification (mail);
• server - SMTP server, the length is not more than 127 characters;
• port - the SMTP service port on the server;
• ssl_active - SSL when communicating with the mail server, true or false;
• starttls - true or false;
• login - the name of the account on the server, the length is not more than 63 characters;
• password - the password of the account on the server, the length is not more than 63 characters;
• from - the address of the sender, the length is not more than 63 characters;
• to - the address of the recipient, not more than 10 addresses with a maximum length of 63 characters each;
• message - message text template, the length is not more than 1023 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="601001" module ="2002" num="1" clas="notifier" type="mailer" name="my_mail" state="off" server="smtp.mail.com" port="465" 
ssl_active="true" starttls="false" login="myself" password="mypass333" to="grandma@mail.kz,grandpa@mail.kz" from="myself@mail.com" 
message="Logic %4:\n--\nDefinition:\n%1\nCurrent sensor state:\n%2\n--\nSystem time: %3" />