1 <?xml version='1.0' encoding='UTF-8'?>
2 <chapter xmlns="http://docbook.org/ns/docbook">
3 <title>Управление админами</title>
4 <para>В этом разделе собраны вызовы API для управления с администраторами системы: удаление, добавление, изменение прав и т.д.</para>
5 <refentry id="stargazer.get_admin">
7 <refentrytitle>stargazer.get_admin</refentrytitle>
10 <refname>stargazer.get_admin</refname>
11 <refpurpose>Получает информацию об администраторе системы</refpurpose>
16 <funcdef><function>stargazer.get_admin</function></funcdef>
17 <paramdef>string <parameter>cookie</parameter></paramdef>
18 <paramdef>string <parameter>login</parameter></paramdef>
23 <title>Description</title>
24 <para>Метод <function>stargazer.get_admin</function> получает информацию об администраторе системы.</para>
27 <term>string <parameter>cookie</parameter></term>
29 <para>Авторизационный cookie. Для авторизации в системе используется метод <function><link linkend="stargazer.login">stargazer.login</link></function></para>
33 <term>string <parameter>login</parameter></term>
35 <para>Логин администратора</para>
40 <title>Return Value</title>
45 <term>boolean <parameter>result</parameter></term>
47 <para>Результат операции. true - успешно, false - неудача (неправильный или устаревший cookie, неправильное название тарифа).</para>
51 <term>string <parameter>login</parameter></term>
53 <para>Логин администратора</para>
57 <term>boolean <parameter>user_stat</parameter></term>
59 <para>Право на изменение статистики пользователя (включая состояние счета)</para>
63 <term>boolean <parameter>user_conf</parameter></term>
65 <para>Право на изменение конфигурации пользователя (включая пароль)</para>
69 <term>boolean <parameter>user_cash</parameter></term>
71 <para>Право на изменение состояния счета пользователя</para>
75 <term>boolean <parameter>user_passwd</parameter></term>
77 <para>Право на изменение пароля пользователя</para>
81 <term>boolean <parameter>user_add_del</parameter></term>
83 <para>Право на добавление и удаление пользователей</para>
87 <term>boolean <parameter>admin_chg</parameter></term>
89 <para>Право на управление администраторами</para>
93 <term>boolean <parameter>tariff_chg</parameter></term>
95 <para>Право на управление тарифами</para>
103 <title>See also</title>
105 <link linkend="stargazer.get_admins"><function>stargazer.get_admins</function></link>,
106 <link linkend="stargazer.add_admin"><function>stargazer.add_admin</function></link>,
107 <link linkend="stargazer.del_admin"><function>stargazer.del_admin</function></link>,
108 <link linkend="stargazer.chg_admin"><function>stargazer.chg_admin</function></link>
112 <refentry id="stargazer.get_admins">
114 <refentrytitle>stargazer.get_admins</refentrytitle>
117 <refname>stargazer.get_admins</refname>
118 <refpurpose>Получает информацию об админах</refpurpose>
123 <funcdef><function>stargazer.get_admins</function></funcdef>
124 <paramdef>string <parameter>cookie</parameter></paramdef>
129 <title>Description</title>
130 <para>Метод <function>stargazer.get_admins</function> получает информацию об админах, зарегистрированных в системе.</para>
133 <term>string <parameter>cookie</parameter></term>
135 <para>Авторизационный cookie. Для авторизации в системе используется метод <function><link linkend="stargazer.login">stargazer.login</link></function></para>
140 <title>Return Value</title>
142 Возвращает массив структур:
145 <term>boolean <parameter>result</parameter></term>
147 <para>Результат операции. true - успешно, false - неудача (неправильный или устаревший cookie, неправильное название тарифа).</para>
151 <term>string <parameter>login</parameter></term>
153 <para>Логин администратора</para>
157 <term>boolean <parameter>user_stat</parameter></term>
159 <para>Право на изменение статистики пользователя (включая состояние счета)</para>
163 <term>boolean <parameter>user_conf</parameter></term>
165 <para>Право на изменение конфигурации пользователя (включая пароль)</para>
169 <term>boolean <parameter>user_cash</parameter></term>
171 <para>Право на изменение состояния счета пользователя</para>
175 <term>boolean <parameter>user_passwd</parameter></term>
177 <para>Право на изменение пароля пользователя</para>
181 <term>boolean <parameter>user_add_del</parameter></term>
183 <para>Право на добавление и удаление пользователей</para>
187 <term>boolean <parameter>admin_chg</parameter></term>
189 <para>Право на управление администраторами</para>
193 <term>boolean <parameter>tariff_chg</parameter></term>
195 <para>Право на управление тарифами</para>
203 <title>See also</title>
205 <link linkend="stargazer.get_admin"><function>stargazer.get_admin</function></link>,
206 <link linkend="stargazer.add_admin"><function>stargazer.add_admin</function></link>,
207 <link linkend="stargazer.del_admin"><function>stargazer.del_admin</function></link>,
208 <link linkend="stargazer.chg_admin"><function>stargazer.chg_admin</function></link>
212 <refentry id="stargazer.del_admin">
214 <refentrytitle>stargazer.del_admin</refentrytitle>
217 <refname>stargazer.del_admin</refname>
218 <refpurpose>Удаляет администратора из системы</refpurpose>
223 <funcdef><function>stargazer.del_admin</function></funcdef>
224 <paramdef>string <parameter>cookie</parameter></paramdef>
225 <paramdef>string <parameter>login</parameter></paramdef>
230 <title>Description</title>
231 <para>Метод <function>stargazer.del_admin</function> удаляет администратора из системы.</para>
234 <term>string <parameter>cookie</parameter></term>
236 <para>Авторизационный cookie. Для авторизации в системе используется метод <function><link linkend="stargazer.login">stargazer.login</link></function></para>
240 <term>string <parameter>login</parameter></term>
242 <para>Логин удаляемого администратора</para>
247 <title>Return Value</title>
248 <para>Возвращает true в случае успеха и false в случае неудачи</para>
252 <title>See also</title>
254 <link linkend="stargazer.get_admins"><function>stargazer.get_admins</function></link>,
255 <link linkend="stargazer.get_admin"><function>stargazer.get_admin</function></link>,
256 <link linkend="stargazer.add_admin"><function>stargazer.add_admin</function></link>,
257 <link linkend="stargazer.chg_admin"><function>stargazer.chg_admin</function></link>
261 <refentry id="stargazer.add_admin">
263 <refentrytitle>stargazer.add_admin</refentrytitle>
266 <refname>stargazer.add_admin</refname>
267 <refpurpose>Добавляет администратора в систему</refpurpose>
272 <funcdef><function>stargazer.add_admin</function></funcdef>
273 <paramdef>string <parameter>cookie</parameter></paramdef>
274 <paramdef>string <parameter>login</parameter></paramdef>
279 <title>Description</title>
280 <para>Метод <function>stargazer.add_admin</function> добавляет администратора в систему.</para>
283 <term>string <parameter>cookie</parameter></term>
285 <para>Авторизационный cookie. Для авторизации в системе используется метод <function><link linkend="stargazer.login">stargazer.login</link></function></para>
289 <term>string <parameter>login</parameter></term>
291 <para>Логин добавляемого администратора</para>
296 <title>Return Value</title>
297 <para>Возвращает true в случае успеха и false в случае неудачи</para>
301 <title>See also</title>
303 <link linkend="stargazer.get_admins"><function>stargazer.get_admins</function></link>,
304 <link linkend="stargazer.get_admin"><function>stargazer.get_admin</function></link>,
305 <link linkend="stargazer.del_admin"><function>stargazer.del_admin</function></link>,
306 <link linkend="stargazer.chg_admin"><function>stargazer.chg_admin</function></link>
310 <refentry id="stargazer.chg_admin">
312 <refentrytitle>stargazer.chg_admin</refentrytitle>
315 <refname>stargazer.chg_admin</refname>
316 <refpurpose>Изменяет права и/или пароль администратора</refpurpose>
321 <funcdef><function>stargazer.chg_admin</function></funcdef>
322 <paramdef>string <parameter>cookie</parameter></paramdef>
323 <paramdef>string <parameter>login</parameter></paramdef>
324 <paramdef>struct <parameter>info</parameter></paramdef>
329 <title>Description</title>
330 <para>Метод <function>stargazer.chg_admin</function> изменяет права и/или пароль администратора системы. Допустимо частичное указание параметров в структуре info. В этом случае изменение затронет только указанные параметры. Дополнительные поля структуры (не входящие в описание) будут проигнорированы.</para>
333 <term>string <parameter>cookie</parameter></term>
335 <para>Авторизационный cookie. Для авторизации в системе используется метод <function><link linkend="stargazer.login">stargazer.login</link></function></para>
339 <term>string <parameter>login</parameter></term>
341 <para>Логин изменяемого администратора</para>
345 <term>struct <parameter>info</parameter></term>
348 Структура с информацией об админе:
351 <term>string <parameter>login</parameter></term>
353 <para>Логин администратора</para>
357 <term>string <parameter>password</parameter></term>
359 <para>Пароль администратора</para>
363 <term>boolean <parameter>user_stat</parameter></term>
365 <para>Право на изменение статистики пользователя (включая состояние счета)</para>
369 <term>boolean <parameter>user_conf</parameter></term>
371 <para>Право на изменение конфигурации пользователя (включая пароль)</para>
375 <term>boolean <parameter>user_cash</parameter></term>
377 <para>Право на изменение состояния счета пользователя</para>
381 <term>boolean <parameter>user_passwd</parameter></term>
383 <para>Право на изменение пароля пользователя</para>
387 <term>boolean <parameter>user_add_del</parameter></term>
389 <para>Право на добавление и удаление пользователей</para>
393 <term>boolean <parameter>admin_chg</parameter></term>
395 <para>Право на управление администраторами</para>
399 <term>boolean <parameter>tariff_chg</parameter></term>
401 <para>Право на управление тарифами</para>
410 <title>Return Value</title>
411 <para>Возвращает true в случае успеха и false в случае неудачи</para>
415 <title>See also</title>
417 <link linkend="stargazer.get_admins"><function>stargazer.get_admins</function></link>,
418 <link linkend="stargazer.get_admin"><function>stargazer.get_admin</function></link>,
419 <link linkend="stargazer.del_admin"><function>stargazer.del_admin</function></link>,
420 <link linkend="stargazer.add_admin"><function>stargazer.add_admin</function></link>