REST API
Hestia REST API доступен для выполнения основных функций панели управления. Например, мы используем его для внутренней синхронизации кластеров DNS и интеграции биллинговой системы WHMCS. API также можно использовать для создания новых учетных записей пользователей, доменов, баз данных или даже для создания альтернативного веб-интерфейса.
Справочник API предоставляет примеры кода PHP, демонстрирующие, как можно интегрировать API в приложение или скрипт. Однако вы также можете использовать любой другой язык для взаимодействия с API.
С выпуском Hestia v1.6.0 мы представили более продвинутую систему API, которая позволит пользователям, не являющимся администраторами, использовать определенные команды.
Я не могу подключиться к API
С выпуском Hestia v1.4.0 мы решили усилить безопасность. Если вы хотите подключиться к API с удаленного сервера, вам сначала нужно будет добавить его IP-адрес в белый список. Чтобы добавить несколько адресов, разделите их новой строкой.
Можно ли отключить API?
Да, вы можете отключить API через настройки сервера. Файл будет удален с сервера, а все соединения будут игнорироваться. Обратите внимание, что некоторые функции могут не работать при отключенном API.
Пароль, ключ API или ключи доступа
Пароль
- Должен использоваться только администратором.
- Изменение пароля администратора требует его обновления везде, где он используется.
- Разрешено запускать все команды.
Ключ API
- Должен использоваться только администратором.
- Изменение пароля администратора не имеет последствий.
- Разрешено запускать все команды.
Ключи доступа
- Зависит от пользователя.
- Может ограничивать разрешения. Например, только
v-purge-nginx-cache
. - Возможность отключить вход другими методами, но при этом разрешить использование ключей API
- Может быть ограничено только администратором или разрешено всем пользователям.
Настройка аутентификации по ключу доступа/секретному ключу
Чтобы создать ключ доступа, следуйте руководству в нашей документации.
Если используемое вами программное обеспечение уже поддерживает формат хэша, используйте ACCESS_KEY:SECRET_KEY
вместо старого ключа API.
Создание ключа API
WARNING
Этот метод был заменен на указанную выше аутентификацию по ключу доступа/секретному ключу. Мы настоятельно рекомендуем использовать этот более безопасный метод.
Запустите команду v-generate-api-key
.
Коды возврата
Значение | Имя | Комментарий |
---|---|---|
0 | OK | Команда успешно выполнена |
1 | E_ARGS | Недостаточно аргументов |
2 | E_INVALID | Недопустимый объект или аргумент |
3 | E_NOTEXIST | Объект не существует |
4 | E_EXISTS | Объект уже существует |
5 | E_SUSPENDED | Объект уже приостановлен |
6 | E_UNSUSPENDED | Объект уже разблокирован |
7 | E_INUSE | Объект не может быть удален, так как он используется другим объектом |
8 | E_LIMIT | Объект не может быть создан из-за ограничений пакета хостинга |
9 | E_PASSWORD | Неверный / недействительный пароль |
10 | E_FORBIDEN | Этот пользователь не может получить доступ к объекту |
11 | E_DISABLED | Подсистема отключена |
12 | E_PARSING | Конфигурация нарушена |
13 | E_DISK | Недостаточно места на диске для завершения действия |
14 | E_LA | Сервер слишком занят для завершения действия |
15 | E_CONNECT | Соединение не удалось. Хост недоступен |
16 | E_FTP | FTP-сервер не отвечает |
17 | E_DB | Сервер базы данных не отвечает |
18 | E_RDD | RRDtool не удалось обновить базу данных |
19 | E_UPDATE | Операция обновления не удалась |
20 | E_RESTART | Перезапуск службы не удался |