API: хост-аккаунты — различия между версиями
Fgsfds (обсуждение | вклад) |
Aglions (обсуждение | вклад) |
||
Строка 137: | Строка 137: | ||
group (post или get) — изменить группу; | group (post или get) — изменить группу; | ||
− | | + | plan (post или get) — изменить план; |
lang (post или get) — изменить язык; | lang (post или get) — изменить язык; | ||
Строка 293: | Строка 293: | ||
action — параметр, тип разблокировки | action — параметр, тип разблокировки | ||
− | * | + | *unsuspend_ftp (post или get) — разблокировать ftp; |
− | * | + | *unsuspend_sites (post или get) — разблокировать сайты; |
− | * | + | *unsuspend_shell (post или get) — разблокировать шел; |
− | * | + | *unsuspend_cron (post или get) — разблокировать крон; |
− | * | + | *unsuspend_panel (post или get) — разблокировать ранель; |
− | * | + | *unsuspend_full (post или get) — разблокировать полностью |
panel_user (post или get) — имя пользователя ISP, к которому применяется операция. | panel_user (post или get) — имя пользователя ISP, к которому применяется операция. | ||
| style="vertical-align: top;" | | | style="vertical-align: top;" | | ||
− | error:0, mess:' | + | error:0, mess:'Разблокировка были успешно применена для пользователя: <username>'; |
− | error:1, mess:'Нечего | + | error:1, mess:'Нечего разблокировать для пользователя: <username>'; |
error:1000, mess:'У вас нет прав для администрирования этого пользователя'; | error:1000, mess:'У вас нет прав для администрирования этого пользователя'; |
Версия 12:58, 15 апреля 2019
Администраторские функции требуют root-права API, чтобы использовать любой логин, размещенный на сервере. Если root-прав нет, можно использовать только свой логин.
Входящие данные, отмеченные звездочкой, обязательны для заполнения.
Модуль |
Функция |
Входящие данные |
Варианты ошибок |
hostacc |
Просмотр данных хост аккаунта (можно без api_full, но только если юзейрнейм хост-аккаунта совпадает). getlistacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; getlistacc (post или get)* — константа, имя операции; language (post или get) — может принимать значение: en/ru (по умолчанию ru); panel_user (post или get) — имя пользователя ISP, к которому применяется операция. |
error:0, mess:'Информация была успешно получена'; error:1, mess:'Произошла ошибка при получении данных'; error:1000, mess:'У вас нет прав для администрирования этого пользователя'; error:1001, mess:'Такой пользователь отсутствует в ISP-панели'. |
hostacc |
Смена шелл-доступа для аккаунта (можно без api_full, но только если юзейрнейм хост-аккаунта совпадает). changeshellacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; changeshellacc (post или get)* — константа, имя операции; shell (post или get)* — включить/выключить шел доступ (может принимать значения yes/no); language (post или get) — может принимать значение: en/ru (по умолчанию ru); panel_user (post или get) — имя пользователя ISP, к которому применяется операция. |
error:0, mess:'Доступ к шеллу был успешно изменен. Текущее значение: вкл./выкл'; error:1, mess:'Произошла ошибка при попытке изменения доступа к шелу'; error:2, mess:'Параметр shell содержит недопустимое значение. Возможные значения: yes/no'; error:1000, mess:'У вас нет прав для администрирования этого пользователя'; error:1001, mess:'Такой пользователь отсутствует в ISP-панели'. |
hostacc |
Смена языка для аккаунта (можно без api_full, но только если юзейрнейм хост-аккаунта совпадает). changelangacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; changelangacc (post или get)* — константа, имя операции; lang (post или get)* - изменить язык (может принимать значения en/ru); language (post или get) — может принимать значение: en/ru (по умолчанию ru); panel_user (post или get) — имя пользователя ISP, к которому применяется операция. |
error:0, mess:'Выбранный язык был успешно установлен, текущий: ru/en'; error:1, mess:'Произошла ошибка при попытке смены языка'; error:2, mess:'Параметр lang содержит недопустимое значение. Возможные значения: ru/en'; error:1000, mess:'У вас нет прав для администрирования этого пользователя'; error:1001, mess:'Такой пользователь отсутствует в ISP-панели'. |
hostacc |
Редактирование хост-аккаунта (только с включенным apifull). edituseracc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; edituseracc (post или get)* — константа, имя операции; lg (post или get) — имя пользователя; ps (post или get) — изменить пароль; ip (post или get) — изменить или добавить IP (перечисляются через запятую); group (post или get) — изменить группу; plan (post или get) — изменить план; lang (post или get) — изменить язык; emailboxes (post или get) — изменить количество почтовых ящиков; bandwidth (post или get) — изменить трафик, указывается в Мб; sites (post или get) — изменить количество сайтов; databases (post или get) — изменить число баз mysql; subdomains (post или get) — изменить количество субдоменов; mailperhour (post или get) — изменить количество писем в час; disk (post или get) — изменить размер дискового пространства (указывается в Мб); ftp_accounts (post или get) — изменить количество ftp аккаунтов; shell_access (post или get) — шел доступ, может быть n/y; owner (post или get) — изменить владельца. language (post или get) — может принимать значение: en/ru (по умолчанию ru); panel_user (post или get) — имя пользователя ISP, к которому применяется операция. |
error:0, mess:'Новые параметры для пользователя были успешно применены'; error:1, mess:'Произошла ошибка при изменении параметров для пользователя: <username>'; error:2, mess:'Ни одной группы не было найдено'; error:3, mess:'Указанной группы для этого пользователя не существует'; error:4, mess:'Имя логина должно содержать не менее 4 символов'; error:5, mess:'Новый пароль должен содержать не менее 7 символов'; error:6, mess:'Значение shell содержит некорректное значение. Допустимо y/n'; error:7, mess:'Ни одного плана не было найдено'; error:8, mess:'Указанного плана для этого пользователя не существует'; error:9, mess:'Указан некорректный язык. Допустимые значения ru/en'; error:10, mess:'<params_name> - допускаются только цифры 0-9'; error:11, mess:'Указанный ip-адрес некорректный'; error:1000, mess:'У вас нет прав для администрирования этого пользователя'; error:1001, mess:'Такой пользователь отсутствует в ISP-панели'; error:1003, mess:'У вас нет прав администратора'; error:100, mess:'У вас нет прав выполнить эту операцию'. |
hostacc |
Удаление хост-аккаунта (только с включенным apifull). deluseracc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; deluseracc (post или get)* — константа, имя операции; panel_user (post или get) — имя пользователя ISP, к которому применяется операция. |
error:0, mess:'Пользователь был успешно удален'; error:1, mess:'Произошла ошибка при удалении пользователя'; error:2, mess:'Такого пользователя нет в системе'; error:1000, mess:'У вас нет прав для администрирования этого пользователя'; error:1001, mess:'Такой пользователь отсутствует в ISP-панели'; error:1003, mess:'У вас нет прав администратора'; error:100, mess:'У вас нет прав выполнить эту операцию'. |
hostacc |
Блокировка хост аккаунта полностью и частично (только с включенным apifull). suspendacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; suspendacc (post или get)* — константа, имя операции; action — параметр, тип блокировки
panel_user (post или get) — имя пользователя ISP, к которому применяется операция. |
error:0, mess:'Блокировки были успешно применены для пользователя: <username>'; error:1, mess:'Нечего блокировать для пользователя: <username>'; error:1000, mess:'У вас нет прав для администрирования этого пользователя'; error:1001, mess:'Такой пользователь отсутствует в ISP-панели'; error:1003, mess:'У вас нет прав администратора'. |
hostacc |
Разблокировка хост-аккаунта (только с включенным apifull). unsuspendacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; unsuspendacc (post или get)* — константа, имя операции; action — параметр, тип разблокировки
panel_user (post или get) — имя пользователя ISP, к которому применяется операция. |
error:0, mess:'Разблокировка были успешно применена для пользователя: <username>'; error:1, mess:'Нечего разблокировать для пользователя: <username>'; error:1000, mess:'У вас нет прав для администрирования этого пользователя'; error:1001, mess:'Такой пользователь отсутствует в ISP-панели'; error:1003, mess:'У вас нет прав администратора'. |
hostacc |
Список хост-аккаунтов (только с включенным apifull). listuseracc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; listuseracc (post или get)* — константа, имя операции. |
error:0, mess:'Список пользователей был успешно получен'; error:1, mess:'Ни одного пользователя не было найдено'; error:1003, mess:'У вас нет прав администратора'. |
hostacc |
Создание хост-аккаунта (только с включенным apifull). adduseracc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; adduseracc (post или get)* — константа, имя операции; $lg (post или get)* — имя нового пользователя; $ps (post или get)* — пароль нового пользователя; plan (post или get)* — имя тарифного плана; group (post или get)* — имя группы; ip (post или get)* — изменить или добавить IP (перечисляются через запятую). |
error:0, mess:'Новый пользователь был успешно добавлен'; error:1, mess:'Произошла ошибка при добавлении нового пользователя'; error:2, mess:'Указанная группа не найдена'; error:3, mess:'Указанный тарифный план не найден'; error:4, mess:'Имя логина должно содержать не менее 4 символов'; error:5, mess:'Пароль должен содержать не менее 7 символов'; error:1003, mess:'У вас нет прав администратора'.
|
hostacc |
Список тарифов (только с включенным apifull). listplanacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; listplanacc (post или get)* — константа, имя операции. |
error:0, mess:'Список тарифных планов был успешно получен'; error:1, mess:'Ни одной тарифного плана не было обнаружено'; error:1003, mess:'У вас нет прав администратора'. |
hostacc |
Просмотр тарифа (только с включенным apifull). viewplanacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; viewplanacc (post или get)* — константа, имя операции; plan (post или get)* — имя тарифного плана. |
error:0, mess:'Данные о тарифном плане были успешно получены'; error:1, mess:'Произошла ошибка при получении данных о тарифном плане'; error:2, mess:'Указанного тарифного плана не существует'; error:3, mess:'Не указано имя тарифного плана'. |
hostacc |
Рредактирование тарифа (только с включенным apifull). editplanacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; editplanacc (post или get)* — константа, имя операции; plan (post или get)* — имя тарифного плана для редактирования; bandwidth (post или get) — пропускная способность в Мб; disk (post или get) — велечина дискового пространства в Мб; sites (post или get) — количество сайтов; subdomains (post или get) — количество поддоменов; databases (post или get) — количество баз mysql; emailboxes (post или get) — число почтовых ящиков; mailperhour (post или get) — количество писем в час; ftp_accounts (post или get) — число аккаунотов ftp; shell (post или get) — доступность шела - y/n; owner (post или get) — владелец; lang (post или get) — язык (ru/en). |
error:0, mess:'Тарифный план был успешно отредактирован'; error:1, mess:'Произошла ошибка при редактировании тарифного плана'; error:2, mess:'Указанного тарифного плана не существует'; error:3, mess:'Значение shell содержит некорректное значение. Допустимо y/n'; error:4, mess:'Указан некорректный язык. Допустимые значения ru/en'; error:10, mess:'<params_name> - допускаются только цифры 0-9'; error:1003, mess:'У вас нет прав администратора'; error:101, mess:'У вас нет прав выполнить эту операцию'. |
hostacc |
Добавление тарифа (только с включенным apifull). addplanacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; addplanacc (post или get)* — константа, имя операции; plan (post или get)* — имя нового тарифного плана; bandwidth (post или get)* — пропускная способность в Мб; disk (post или get)* — велечина дискового пространства в Мб; sites (post или get)* — количество сайтов; subdomains (post или get)* — количество поддоменов; databases (post или get)* — количество баз mysql; emailboxes (post или get)* — число почтовых ящиков; mailperhour (post или get)* — количество писем в час; ftp_accounts (post или get)* — число аккаунотов ftp; shell (post или get)* — доступность шела (y/n); owner (post или get) — владелец (по умолчанию " "); lang (post или get) — язык (ru/en). |
error:0, mess:'Новый тарифный план был успешно создан'; error:1, mess:'Произошла ошибка при создании нового тарифного плана'; error:2, mess:'Такой тарифный план уже существует'; error:3, mess:'Задано некорректное имя нового тарифного плана'; error:4, mess:'Значение shell содержит некорректное значение. Допустимо y/n'; error:5, mess:'Указан некорректный язык. Допустимые значения ru/en'; error:10, mess:'<params_name> - допускаются только цифры 0-9'; error:1003, mess:'У вас нет прав администратора'; error:101, mess:'У вас нет прав выполнить эту операцию'. |
hostacc |
Удаление тарифа (только с включенным apifull). delplanacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; delplanacc(post или get)* — константа, имя операции; plan (post или get)* — имя нового тарифного плана для удаления. |
error:0, mess:'Тарифный план был успешно удален'; error:1, mess:'Произошла ошибка при удалении тарифного плана'; error:2, mess:'Такого тарифного плана не существует'; error:3, mess:'Не указано имя тарифного плана для удаления'; error:1003, mess:'У вас нет прав администратора'; error:101, mess:'У вас нет прав выполнить эту операцию'. |
hostacc |
Список групп (только с включенным apifull). listgroupacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; listgroupacc (post или get)* — константа, имя операции. |
error:0, mess:'Список групп был успешно получен'; error:1, mess:'Ни одной группы не было обнаружено'; error:1003, mess:'У вас нет прав администратора'. |
hostacc |
Просмотр группы (только с включенным apifull). viewgroupacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; viewgroupacc (post или get)* — константа, имя операции; group (post или get)* — имя группы. |
error:0, mess:'Данные о группе были успешно получены'; error:1, mess:'Произошла ошибка при получении данных о группе; '<groupname>; error:1003, mess:'У вас нет прав администратора'. |
hostacc |
Добавление группы (только с включенным apifull). addgroupacc |
group (post или get)* — имя группы; root (post или get) — доступ root; ftp_restart (post или get) — перезагрузка ftp; ftp_install (post или get) — переустановка ftp; reseller (post или get) — посредник; reseller_planview (post или get) — просматривать план посреднику; reseller_groupview (post или get) — просматривать группу посреднику; reseller_groupcreate (post или get) — создавать группу посреднику; reseller_plancreate (post или get) — создовать план посреднику; api (post или get) — доступ по API; apifull (post или get) — полный доступ по API(администратор). |
error:0, mess:'Новая группа была успешно добавлена'; error:1, mess:'Произошла ошибка при добавлении новой группы'; error:2, mess:'Такая группа уже существует'; error:3, mess:'Задано некорректное значение новой группы'; error:4, mess:'<paramname> - параметр задан некорректно. Может быть y/n/"" (пустая строка)'; error:1003, mess:'У вас нет прав администратора'. |
hostacc |
Редактирование группы (только с включенным apifull). editgroupacc |
group (post или get)* — имя группы; root (post или get) — доступ root; ftp_restart (post или get) — перезагрузка ftp; ftp_install (post или get) — переустановка ftp; reseller (post или get) — посредник; reseller_planview (post или get) — просматривать план посреднику; reseller_groupview (post или get) — просматривать группу посреднику; reseller_groupcreate (post или get) — создавать группу посреднику; reseller_plancreate (post или get) — создовать план посреднику; api (post или get) — доступ по API; apifull (post или get) — полный доступ по API(администратор). |
error:0, mess:'Группа была успешно отредактирована'; error:1, mess:'Произошла ошибка при редактировании группы';; error:2, mess:'Указанная группа не была найдена или не определена' error:3, mess:'<paramname> - параметр задан некорректно. Может быть y/n/"" (пустая строка)'; error:1003, mess:'У вас нет прав администратора'. |
hostacc |
Удаление группы (только с включенным apifull). delgroupacc |
username (post или get)* — имя пользователя; password (post или get)* — пароль пользователя; hostacc (post или get)* — константа, имя модуля; delgroupacc (post или get)* — константа, имя операции; group (post или get)* — имя группы. |
error:0, mess:'Группа была успешно удалена'; error:1, mess:'Произошла ошибка при удалении группы'; error:2, mess:'Такой группы не существует'; error:3, mess:'Имя группы не определено или некорректно'; error:1003, mess:'У вас нет прав администратора'. |
Другие полезные статьи: