API: host-accounts

2019-08-08T13:15:38Z

213.87.155.165: Ошибки с входяшими данными

Администраторские функции требуют root-права API, чтобы использовать любой логин, размещенный на сервере. Если root-прав нет, можно использовать только свой логин.

Входящие данные, отмеченные звездочкой, обязательны для заполнения. 

{| cellpadding="5" border="1"
|-
| '''Модуль'''
| '''Функция'''
| '''Входящие данные'''
| '''Варианты ошибок'''
|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Просмотр данных хост аккаунта (можно без api_full, но только если юзейрнейм хост-аккаунта совпадает).

getlistacc  

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

getlistacc (post или get)* — константа, имя операции;

language (post или get) — может принимать значение: en/ru (по умолчанию ru);

panel_user (post или get) — имя пользователя ISP, к которому применяется операция.

| style="vertical-align: top" |
error:0, mess:'Информация была успешно получена';

error:1, mess:'Произошла ошибка при получении данных';

error:1000, mess:'У вас нет прав для администрирования этого пользователя';

error:1001, mess:'Такой пользователь отсутствует в ISP-панели'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Смена шелл-доступа для аккаунта (можно без api_full, но только если юзейрнейм хост-аккаунта совпадает).

changeshellacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

changeshellacc (post или get)* — константа, имя операции;     

shell (post или get)* — включить/выключить шел доступ (может принимать значения yes/no);

language (post или get) — может принимать значение: en/ru (по умолчанию ru);

panel_user (post или get) — имя пользователя ISP, к которому применяется операция.

| style="vertical-align: top" |
error:0, mess:'Доступ к шеллу был успешно изменен. Текущее значение: вкл./выкл';

error:1, mess:'Произошла ошибка при попытке изменения доступа к шелу';

error:2, mess:'Параметр shell содержит недопустимое значение. Возможные значения: yes/no';

error:1000, mess:'У вас нет прав для администрирования этого пользователя';

error:1001, mess:'Такой пользователь отсутствует в ISP-панели'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Смена языка для аккаунта  (можно без api_full, но только если юзейрнейм хост-аккаунта совпадает).

changelangacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

changelangacc (post или get)* — константа, имя операции;     

lang (post или get)* - изменить язык (может принимать значения en/ru);

language (post или get) — может принимать значение: en/ru (по умолчанию ru);

panel_user (post или get) — имя пользователя ISP, к которому применяется операция.

| style="vertical-align: top" |  
error:0, mess:'Выбранный язык был успешно установлен, текущий: ru/en';

error:1, mess:'Произошла ошибка при попытке смены языка';

error:2, mess:'Параметр lang содержит недопустимое значение. Возможные значения: ru/en';

error:1000, mess:'У вас нет прав для администрирования этого пользователя';

error:1001, mess:'Такой пользователь отсутствует в ISP-панели'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Редактирование хост-аккаунта (только с включенным apifull).

edituseracc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (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, к которому применяется операция.

| style="vertical-align: top" |
error:0, mess:'Новые параметры для пользователя были успешно применены';

error:1, mess:'Произошла ошибка при изменении параметров для пользователя: <login>';

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:'У вас нет прав выполнить эту операцию'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Удаление хост-аккаунта (только с включенным apifull).

deluseracc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

deluseracc (post или get)* — константа, имя операции;     

panel_user (post или get) — имя пользователя ISP, к которому применяется операция.

| style="vertical-align: top" |
error:0, mess:'Пользователь был успешно удален';

error:1, mess:'Произошла ошибка при удалении пользователя';

error:2, mess:'Такого пользователя нет в системе';

error:1000, mess:'У вас нет прав для администрирования этого пользователя';

error:1001, mess:'Такой пользователь отсутствует в ISP-панели';

error:1003, mess:'У вас нет прав администратора';

error:100, mess:'У вас нет прав выполнить эту операцию'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Блокировка хост аккаунта полностью и частично (только с включенным apifull).

suspendacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

suspendacc (post или get)* — константа, имя операции;

action — параметр, тип блокировки

*suspend_ftp (post или get) — блокировать ftp;
*suspend_sites (post или get) — блокировать сайты;
*suspend_shell (post или get) — блокировать шел;
*suspend_cron (post или get) — блокировать крон;
*suspend_panel (post или get) — блокировать ранель;
*suspend_full (post или get) — блокировать полностью

panel_user (post или get) — имя пользователя ISP, к которому применяется операция.

| style="vertical-align: top" |
error:0, mess:'Блокировки были успешно применены для пользователя: <login>';

error:1, mess:'Нечего блокировать для пользователя: <login>';

error:1000, mess:'У вас нет прав для администрирования этого пользователя';

error:1001, mess:'Такой пользователь отсутствует в ISP-панели';

error:1003, mess:'У вас нет прав администратора'.  

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Разблокировка хост-аккаунта (только с включенным apifull).

unsuspendacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

unsuspendacc (post или get)* — константа, имя операции;

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, к которому применяется операция.

| style="vertical-align: top" |
error:0, mess:'Разблокировка были успешно применена для пользователя: <login>';

error:1, mess:'Нечего разблокировать для пользователя: <login>';

error:1000, mess:'У вас нет прав для администрирования этого пользователя';

error:1001, mess:'Такой пользователь отсутствует в ISP-панели';

error:1003, mess:'У вас нет прав администратора'.  

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Список хост-аккаунтов (только с включенным apifull).

listuseracc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

listuseracc (post или get)* — константа, имя операции.

| style="vertical-align: top" |
error:0, mess:'Список пользователей был успешно получен';

error:1, mess:'Ни одного пользователя не было найдено';

error:1003, mess:'У вас нет прав администратора'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Создание хост-аккаунта (только с включенным apifull).

adduseracc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

adduseracc (post или get)* — константа, имя операции;

$lg (post или get)* — имя нового пользователя;

$ps (post или get)* — пароль нового пользователя;

plan (post или get)* — имя тарифного плана;

group (post или get)* — имя группы;

ip (post или get)* — изменить или добавить IP (перечисляются через запятую).

| style="vertical-align: top" |
error:0, mess:'Новый пользователь был успешно добавлен';

error:1, mess:'Произошла ошибка при добавлении нового пользователя';

error:2, mess:'Указанная группа не найдена';

error:3, mess:'Указанный тарифный план не найден';

error:4, mess:'Имя логина должно содержать не менее 4 символов';

error:5, mess:'Пароль должен содержать не менее 7 символов';

error:1003, mess:'У вас нет прав администратора'.

 

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Список тарифов (только с включенным apifull).

listplanacc  

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

listplanacc (post или get)* — константа, имя операции.

| style="vertical-align: top" |
error:0, mess:'Список тарифных планов был успешно получен';

error:1, mess:'Ни одной тарифного плана не было обнаружено';

error:1003, mess:'У вас нет прав администратора'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Просмотр тарифа (только с включенным apifull).

viewplanacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

viewplanacc (post или get)* — константа, имя операции;

plan (post или get)* — имя тарифного плана.

| style="vertical-align: top" |
error:0, mess:'Данные о тарифном плане были успешно получены';

error:1, mess:'Произошла ошибка при получении данных о тарифном плане';

error:2, mess:'Указанного тарифного плана не существует';

error:3, mess:'Не указано имя тарифного плана'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Рредактирование тарифа (только с включенным apifull).

editplanacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (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).

| style="vertical-align: top" |
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:'У вас нет прав выполнить эту операцию'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Добавление тарифа (только с включенным apifull).

addplanacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (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).

| style="vertical-align: top" |  
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:'У вас нет прав выполнить эту операцию'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Удаление тарифа (только с включенным apifull).

delplanacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

delplanacc(post или get)* — константа, имя операции;

plan (post или get)* — имя нового тарифного плана для удаления.

| style="vertical-align: top" |
error:0, mess:'Тарифный план был успешно удален';

error:1, mess:'Произошла ошибка при удалении тарифного плана';

error:2, mess:'Такого тарифного плана не существует';

error:3, mess:'Не указано имя тарифного плана для удаления';

error:1003, mess:'У вас нет прав администратора';

error:101, mess:'У вас нет прав выполнить эту операцию'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Список групп (только с включенным apifull).

listgroupacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

listgroupacc (post или get)* — константа, имя операции.

| style="vertical-align: top" |
error:0, mess:'Список групп был успешно получен';

error:1, mess:'Ни одной группы не было обнаружено';

error:1003, mess:'У вас нет прав администратора'.

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Просмотр группы (только с включенным apifull).

viewgroupacc

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

viewgroupacc (post или get)* — константа, имя операции;

group (post или get)* — имя группы.

| style="vertical-align: top" |
error:0, mess:'Данные о группе были успешно получены';

error:1, mess:'Произошла ошибка при получении данных о группе; '<groupname>;

error:1003, mess:'У вас нет прав администратора'.  

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Добавление группы (только с включенным apifull).

addgroupacc

| style="vertical-align: top" |  
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(администратор).

| style="vertical-align: top" |
error:0, mess:'Новая группа была успешно добавлена';

error:1, mess:'Произошла ошибка при добавлении новой группы';

error:2, mess:'Такая группа уже существует';

error:3, mess:'Задано некорректное значение новой группы';

error:4, mess:'<paramname> -  параметр задан некорректно. Может быть y/n/"" (пустая строка)';

error:1003, mess:'У вас нет прав администратора'.  

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Редактирование группы (только с включенным apifull).

editgroupacc

| style="vertical-align: top" |
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(администратор).

| style="vertical-align: top" |
error:0, mess:'Группа была успешно отредактирована';

error:1, mess:'Произошла ошибка при редактировании группы';;

error:2, mess:'Указанная группа не была найдена или не определена'

error:3, mess:'<paramname> -  параметр задан некорректно. Может быть y/n/"" (пустая строка)';

error:1003, mess:'У вас нет прав администратора'.  

|-
| style="vertical-align: top" |
hostacc

| style="vertical-align: top" |
Удаление группы (только с включенным apifull).

delgroupacc  

| style="vertical-align: top" |
login (post или get)* — имя пользователя;

pass (post или get)* — пароль пользователя;

hostacc (post или get)* — константа, имя модуля;

delgroupacc (post или get)* — константа, имя операции;

group (post или get)* — имя группы.

| style="vertical-align: top" |
error:0, mess:'Группа была успешно удалена';

error:1, mess:'Произошла ошибка при удалении группы';

error:2, mess:'Такой группы не существует';

error:3, mess:'Имя группы не определено или некорректно';

error:1003, mess:'У вас нет прав администратора'.

|}

Другие полезные статьи:

{| style="width: 1191px"
|-
|
'''[https://docs.brainycp.io/index.php/API:_подключение API: подключение]'''

|
'''[https://docs.brainycp.io/index.php/API:_мониторинг API: мониторинг]'''

|
'''[https://docs.brainycp.io/index.php/API:_статус_веб-сервера API: статус веб-сервера]'''

|-
|
'''[https://docs.brainycp.io/index.php/API:_автоустановщик_CMS API: автоустановщик CMS]'''

|
'''[https://docs.brainycp.io/index.php/API:_настройка_бекапов API: настройка бекапов]'''

|
'''[https://docs.brainycp.io/index.php/API:_трансфер_между_серверами API: трансфер между серверами]'''

|-
|
'''[https://docs.brainycp.io/index.php/API:_антивирус API: антивирус]'''

|
'''[https://docs.brainycp.io/index.php/API:_настройки_сервера API: настройки сервера]'''

|
'''[https://docs.brainycp.io/index.php/API:_управление_веб-сервером API: управление веб-сервером]'''

|-
|
'''[https://docs.brainycp.io/index.php/API:_базы_данных API: базы данных]'''

|
'''[https://docs.brainycp.io/index.php/API:_пользовательские_сертификаты API: пользовательские сертификаты]'''

|
'''[https://docs.brainycp.io/index.php/API:_управление_почтовыми_ящиками API: управление почтовыми ящиками]'''

|-
|
'''[https://docs.brainycp.io/index.php/API:_информация_о_сервере API: информация о сервере]'''

|
'''[https://docs.brainycp.io/index.php/API:_почта API: почта]'''

|
'''[https://docs.brainycp.io/index.php/API:_управление_DNS-зонами API: управление DNS-зонами]'''

|-
|
'''[https://docs.brainycp.io/index.php/API:_использование_трафика API: использование трафика]'''

|
'''[https://docs.brainycp.io/index.php/API:_почтовые_ящики_клиента API: почтовые ящики клиента]'''

|
'''[https://docs.brainycp.io/index.php/API:_установка_веб-сервера API: установка веб-сервера]'''

|-
|
'''[https://docs.brainycp.io/index.php/API:_логирование API: логирование]'''

|
'''[https://docs.brainycp.io/index.php/API:_сервер_имен API: сервер имен]'''

|
'''[https://docs.brainycp.io/index.php/API:_хост-аккаунты API: хост-аккаунты]'''

|-
|
'''[https://docs.brainycp.io/index.php/API:_менеджер_приложений API: менеджер приложений]'''

|
'''[https://docs.brainycp.io/index.php/API:_сертификаты_сервисов API: сертификаты сервисов]'''

|
'''[https://docs.brainycp.io/index.php/API:_CRON API: CRON]'''

|-
|
'''[https://docs.brainycp.io/index.php/API:_менеджер_процессов API: менеджер процессов]'''

|
'''[https://docs.brainycp.io/index.php/API:_сетевые_инструменты API: сетевые инструменты]'''

|
'''[https://docs.brainycp.io/index.php/API:_FTP-сервер API: FTP-сервер]'''

|-
|
'''[https://docs.brainycp.io/index.php/API:_менеджер_IP-адресов API: менеджер IP-адресов]'''

|
'''[https://docs.brainycp.io/index.php/API:_средняя_нагрузка API: средняя нагрузка]'''

|
'''[https://docs.brainycp.io/index.php/API:_MySQL_processlist API: MySQL processlist]'''

|}

BrainyCP - User contributions [en]

API: host-accounts