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

Материал из BrainyCP
Перейти к: навигация, поиск
Строка 231: Строка 231:
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_подключение API: подключение]'''
+
'''[https://docs.brainycp.com/index.php/API:_подключение API: подключение]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_мониторинг API: мониторинг]'''
+
'''[https://docs.brainycp.com/index.php/API:_мониторинг API: мониторинг]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_статус_веб-сервера API: статус веб-сервера]'''
+
'''[https://docs.brainycp.com/index.php/API:_статус_веб-сервера API: статус веб-сервера]'''
  
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_автоустановщик_CMS API: автоустановщик CMS]'''
+
'''[https://docs.brainycp.com/index.php/API:_автоустановщик_CMS API: автоустановщик CMS]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_настройка_бекапов API: настройка бекапов]'''
+
'''[https://docs.brainycp.com/index.php/API:_настройка_бекапов API: настройка бекапов]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_трансфер_между_серверами API: трансфер между серверами]'''
+
'''[https://docs.brainycp.com/index.php/API:_трансфер_между_серверами API: трансфер между серверами]'''
  
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_антивирус API: антивирус]'''
+
'''[https://docs.brainycp.com/index.php/API:_антивирус API: антивирус]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_настройки_сервера API: настройки сервера]'''
+
'''[https://docs.brainycp.com/index.php/API:_настройки_сервера API: настройки сервера]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_управление_веб-сервером API: управление веб-сервером]'''
+
'''[https://docs.brainycp.com/index.php/API:_управление_веб-сервером API: управление веб-сервером]'''
  
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_базы_данных API: базы данных]'''
+
'''[https://docs.brainycp.com/index.php/API:_базы_данных API: базы данных]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_пользовательские_сертификаты API: пользовательские сертификаты]'''
+
'''[https://docs.brainycp.com/index.php/API:_пользовательские_сертификаты API: пользовательские сертификаты]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_управление_почтовыми_ящиками API: управление почтовыми ящиками]'''
+
'''[https://docs.brainycp.com/index.php/API:_управление_почтовыми_ящиками API: управление почтовыми ящиками]'''
  
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_информация_о_сервере API: информация о сервере]'''
+
'''[https://docs.brainycp.com/index.php/API:_информация_о_сервере API: информация о сервере]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_почта API: почта]'''
+
'''[https://docs.brainycp.com/index.php/API:_почта API: почта]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_управление_DNS-зонами API: управление DNS-зонами]'''
+
'''[https://docs.brainycp.com/index.php/API:_управление_DNS-зонами API: управление DNS-зонами]'''
  
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_использование_трафика API: использование трафика]'''
+
'''[https://docs.brainycp.com/index.php/API:_использование_трафика API: использование трафика]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_почтовые_ящики_клиента API: почтовые ящики клиента]'''
+
'''[https://docs.brainycp.com/index.php/API:_почтовые_ящики_клиента API: почтовые ящики клиента]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_установка_веб-сервера API: установка веб-сервера]'''
+
'''[https://docs.brainycp.com/index.php/API:_установка_веб-сервера API: установка веб-сервера]'''
  
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_логирование API: логирование]'''
+
'''[https://docs.brainycp.com/index.php/API:_логирование API: логирование]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_сервер_имен API: сервер имен]'''
+
'''[https://docs.brainycp.com/index.php/API:_сервер_имен API: сервер имен]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_хост-аккаунты API: хост-аккаунты]'''
+
'''[https://docs.brainycp.com/index.php/API:_хост-аккаунты API: хост-аккаунты]'''
  
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_менеджер_приложений API: менеджер приложений]'''
+
'''[https://docs.brainycp.com/index.php/API:_менеджер_приложений API: менеджер приложений]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_сертификаты_сервисов API: сертификаты сервисов]'''
+
'''[https://docs.brainycp.com/index.php/API:_сертификаты_сервисов API: сертификаты сервисов]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_CRON API: CRON]'''
+
'''[https://docs.brainycp.com/index.php/API:_CRON API: CRON]'''
  
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_менеджер_процессов API: менеджер процессов]'''
+
'''[https://docs.brainycp.com/index.php/API:_менеджер_процессов API: менеджер процессов]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_сетевые_инструменты API: сетевые инструменты]'''
+
'''[https://docs.brainycp.com/index.php/API:_сетевые_инструменты API: сетевые инструменты]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_FTP-сервер API: FTP-сервер]'''
+
'''[https://docs.brainycp.com/index.php/API:_FTP-сервер API: FTP-сервер]'''
  
 
|-
 
|-
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_менеджер_IP-адресов API: менеджер IP-адресов]'''
+
'''[https://docs.brainycp.com/index.php/API:_менеджер_IP-адресов API: менеджер IP-адресов]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_средняя_нагрузка API: средняя нагрузка]'''
+
'''[https://docs.brainycp.com/index.php/API:_средняя_нагрузка API: средняя нагрузка]'''
  
 
|  
 
|  
'''[https://docs.brainycp.ru/index.php/API:_MySQL_processlist API: MySQL processlist]'''
+
'''[https://docs.brainycp.com/index.php/API:_MySQL_processlist API: MySQL processlist]'''
  
 
|}
 
|}

Версия 12:11, 22 ноября 2017

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

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

Модуль

Функция

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

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

certs_control

Просмотр сертификатов пользователя.

listcerts

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

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

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

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

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

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

error:0, mess:'Список сертификатов был успешно получен для пользователя: <name>', data: содержит список сертификатов;

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

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

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

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

certs_control

Удалить сертификат и ключ.

delcerts

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

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

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

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

key_name (post)* — имя для удаления;

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

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

error:0, mess:'Ключ и сертификат были успешно удалены для пользователя: <name>';

error:1, mess:'Требуемый сертификат не может быть удален так как он используется';

error:2, mess:'Нет такого ключа и сертификата. Нечего удалять';

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

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

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

certs_control

Создание ключа и сертификата.

addcerts

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

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

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

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

key_size (post) — размер ключа (по умолчанию 2048; может быть 4096);

domain (post)* — домен, для которого применяется сертификат;

country (post)* — страна (определяется двумя символами; по умолчанию 'ru');

state (post)* — штат (строковая переменная);

city (post)* — город (строковая переменная);

company (post)* — компания (строковая переменная);

division (post)* — отдел (строковая переменная);

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

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

error:0, mess:'Новый сертификат был успешно добавлен для пользователя: <name>', data: содержит имя нового ключа и сертификата;

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

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

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

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

certs_control

Добавление ключа и сертификата к домену.

savedomaincerts

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

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

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

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

domain (post)* — домен для которого применяется сертификат;

key (post)* — ключ который применяется к домену. Или указать опцию 'letencrypt' для генерации ключа этого типа;

key_mail (post) — применить ключ для почты: yes/no (по умолчанию - no).

error:0, mess:'Сертификат біл установлен для домена: <domain>';

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

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

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

certs_control

Получить список доменов с сертификатами.

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

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

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

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

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

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

error:0, mess:'Список доменов использующие сертификаты был получен для пользователя: <name>', data: содержит список доменов;

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

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

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

certs_control

Удалить сертификат с домена.

deldomaincerts

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

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

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

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

domain (post)* — домен для которого удаляется сертификат;

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

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

error:0, mess:'Сертификат был убран с домена';

error:1, mess:'Ошибка, такой домен не найден или не содержит никакого сертификата';

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

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

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

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

API: подключение

API: мониторинг

API: статус веб-сервера

API: автоустановщик CMS

API: настройка бекапов

API: трансфер между серверами

API: антивирус

API: настройки сервера

API: управление веб-сервером

API: базы данных

API: пользовательские сертификаты

API: управление почтовыми ящиками

API: информация о сервере

API: почта

API: управление DNS-зонами

API: использование трафика

API: почтовые ящики клиента

API: установка веб-сервера

API: логирование

API: сервер имен

API: хост-аккаунты

API: менеджер приложений

API: сертификаты сервисов

API: CRON

API: менеджер процессов

API: сетевые инструменты

API: FTP-сервер

API: менеджер IP-адресов

API: средняя нагрузка

API: MySQL processlist