API: управление почтовыми ящиками — различия между версиями

Материал из BrainyCP
Перейти к: навигация, поиск
(Новая страница: « Администраторские функции требуют root-права API, чтобы использовать любой логин, размещен…»)
(нет различий)

Версия 16:47, 31 января 2017

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

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

Модуль

Функция

Входящие данные

Варианты ошибок

mailclient

Добавление почтового ящика.

addmail

username (post)* — имя пользователя;

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

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

addmail (post)* — константа, тип операции;

email (post)* — почтовый ящик в формате userbox@domain;

password (post)* — пароль на почтовый ящик;

quota (post)* — квота;

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

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

error:0, mess:'Почтовый ящик успешно добавлен:<boxname>';

error:1, mess:'Такой почтовый ящик уже существует: <boxname>';

error:2, mess:'Ошибка в массиве параметров';

error:3, mess:'Возникла ошибка при добавлении почтового ящика:<boxname>';

error:4, mess:'Указанный домен в почтовом ящике не найден в системе:<boxname>';

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

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

mailclient

Удаление почтового ящика.

delmail

username (post)* — имя пользователя;

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

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

delmail (post)* — константа, тип операции;

email (post)* — почтовый ящик в формате userbox@domain;

password (post)* — пароль на почтовый ящик;

quota (post)* — квота;

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

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

error:0, mess:'Почтовый ящик успешно удален';

error:1, mess:'Ошибка удаления почтового ящика: <err_msg>';

error:2, mess:'Ошибка в массиве параметров';

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

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

mailclient

Добавление почтового перенаправления.

addforward

username (post)* — имя пользователя;

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

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

addforward (post)* — константа, тип операции;

source — исходный почтовый ящик в формате userbox@domain;

target — почтовый ящик назначения в формате userbox@domain (можно указать несколько через запятую);

save_local — сохранять перенаправляемую почту.

error:0, mess:'Перенаправление почтового ящика успешно определено: <source> => <target>';

error:1, mess:'Ошибка перенаправления почтового ящика: <err_msg>';

error:2, mess:'Ошибка в массиве параметров';

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

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

mailclient

Удаление почтового перенаправления.

delforward

username (post)* — имя пользователя;

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

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

delforward (post)* — константа, тип операции;

source — исходный почтовый ящик в формате userbox@domain;

target — почтовый ящик назначения в формате userbox@domain (можно указать несколько через запятую).

error:0, mess:'Перенаправление почтового ящика было удалено';

error:1, mess:'Ошибка удаления перенаправления почтового ящика: <err_msg>';

error:2, mess:'Ошибка в массиве параметров';

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

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

mailclient

Включить spf-запись для домена.

onspf

username (post)* — имя пользователя;

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

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

onspf (post)* — константа, тип операции;

domain — имя домена.

error:0, mess:'Запись для домена включена';

error:1, mess:'Ошибка в массиве параметров';

error:2, mess:'Ошибка включения записи SPF для домена <domen>';

error:3, mess:'SPF уже включен для домена: <domen>'.

mailclient

Отключить spf запись для домена.

offspf

username (post)* — имя пользователя;

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

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

offspf (post)* — константа, тип операции;

domain — имя домена.

error:0, mess:'Запись для домена выключена';

error:1, mess:'Ошибка в массиве параметров';

error:2, mess:'Ошибка отключения записи SPF для домена <domen>';

error:3, mess:'SPF уже выключен для домена: <domen>'.

mailclient

Включить dkim запись для домена.

ondkim

username (post)* — имя пользователя;

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

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

ondkim (post)* — константа, тип операции;

domain — имя домена.

error:0, mess:'Запись для домена включена';

error:1, mess:'Ошибка в массиве параметров';

error:2, mess:'Ошибка включения dkim записи для домена <domen>';

error:3, mess:'dkim уже включен для домена: <domen>'.

mailclient

Отключить dkim запись для домена.

offdkim

username (post)* — имя пользователя;

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

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

offdkim (post)* — константа, тип операции;

domain — имя домена.

error:0, mess:'Запись для домена выключена';

error:1, mess:'Ошибка в массиве параметров';

error:2, mess:'Ошибка отключения записи Dkim для домена <domen>';

error:3, mess:'Dkim уже выключен для домена: <domen>'.