X-Git-Url: https://git.stg.codes/stg.git/blobdiff_plain/335f5e8f4be04e68fa76f64c722613efc6fb98fa..06c1548a92767365aa31a7af539475d535a33da3:/doc/xmlrpc-doc/API-messages.xml?ds=sidebyside

diff --git a/doc/xmlrpc-doc/API-messages.xml b/doc/xmlrpc-doc/API-messages.xml
new file mode 100644
index 00000000..0a16d524
--- /dev/null
+++ b/doc/xmlrpc-doc/API-messages.xml
@@ -0,0 +1,102 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<chapter xmlns="http://docbook.org/ns/docbook">
+    <title>Управление сообщениями пользователю</title>
+    <para>В этом разделе собраны вызовы API для отправки сообщений пользователям.</para>
+    <refentry id="stargazer.send_message">
+        <refmeta>
+            <refentrytitle>stargazer.send_message</refentrytitle>
+        </refmeta>
+        <refnamediv>
+            <refname>stargazer.send_message</refname>
+            <refpurpose>Отправляет сообщение пользователям</refpurpose>
+        </refnamediv>
+        <refsynopsisdiv>
+            <funcsynopsis>
+                <funcprototype>
+                    <funcdef><function>stargazer.send_message</function></funcdef>
+                    <paramdef>string <parameter>cookie</parameter></paramdef>
+                    <paramdef>array of strings <parameter>logins</parameter></paramdef>
+                    <paramdef>struct <parameter>info</parameter></paramdef>
+                </funcprototype>
+            </funcsynopsis>
+        </refsynopsisdiv>
+        <refsect1>
+            <title>Description</title>
+            <para>Метод <function>stargazer.send_message</function> отправляет сообщение пользователям, логины которых перечислены в списке.</para>
+            <variablelist>
+                <varlistentry>
+                    <term>string <parameter>cookie</parameter></term>
+                    <listitem>
+                        <para>Авторизационный cookie. Для авторизации в системе используется метод <function><link linkend="stargazer.login">stargazer.login</link></function></para>
+                    </listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>array of strings <parameter>logins</parameter></term>
+                    <listitem>
+                        <para>Список логинов пользователей</para>
+                    </listitem>
+                </varlistentry>
+                <varlistentry>
+                    <term>struct <parameter>info</parameter></term>
+                    <listitem>
+                        <para>
+                            Структура с параметрами сообщения:
+                            <variablelist>
+                                <varlistentry>
+                                    <term>int <parameter>version</parameter></term>
+                                    <listitem>
+                                        <para>Версия системы сообщений (не обязательный параметр, по умолчанию - 1)</para>
+                                    </listitem>
+                                </varlistentry>
+                            </variablelist>
+                            <variablelist>
+                                <varlistentry>
+                                    <term>int <parameter>type</parameter></term>
+                                    <listitem>
+                                        <para>Тип сообщения (не обязательный параметр, по умолчанию - 1)</para>
+                                    </listitem>
+                                </varlistentry>
+                            </variablelist>
+                            <variablelist>
+                                <varlistentry>
+                                    <term>int <parameter>repeat</parameter></term>
+                                    <listitem>
+                                        <para>Количество показов сообщеня</para>
+                                    </listitem>
+                                </varlistentry>
+                            </variablelist>
+                            <variablelist>
+                                <varlistentry>
+                                    <term>int <parameter>repeat_period</parameter></term>
+                                    <listitem>
+                                        <para>Период повторения показа сообщений (в минутах)</para>
+                                    </listitem>
+                                </varlistentry>
+                            </variablelist>
+                            <variablelist>
+                                <varlistentry>
+                                    <term>int <parameter>show_time</parameter></term>
+                                    <listitem>
+                                        <para>Время отображения сообщения (в секундах)</para>
+                                    </listitem>
+                                </varlistentry>
+                            </variablelist>
+                            <variablelist>
+                                <varlistentry>
+                                    <term>string <parameter>text</parameter></term>
+                                    <listitem>
+                                        <para>Текст сообщения в кодировке CP1251</para>
+                                    </listitem>
+                                </varlistentry>
+                            </variablelist>
+                        </para>
+                    </listitem>
+                </varlistentry>
+            </variablelist>
+            <refsect2>
+                <title>Return Value</title>
+                <para>Возвращает true в случае успеха и false в случае неудачи</para>
+            </refsect2>
+        </refsect1>
+    </refentry>
+</chapter>