Използване на DirectAdmin API: управление на Вашия пакет чрез скриптове

DirectAdmin разполага с API: начин да управлявате Вашия пакет чрез скрипт или програма, вместо с мишката. Почти всичко, което правите в панела, може да се извърши и чрез API. Помислете за актуализиране на DNS запис, когато се промени Вашият IP адрес у дома, създаване на пощенски кутии от Вашия собствен софтуер или получаване на списък с Вашите бази данни всяка нощ.

Мога ли да използвам API с моя пакет?

Да. API работи с всеки пакет, който включва DirectAdmin: всички пакети за уеб хостинг, както и пакетите за имейл. Освен това Resellers могат да управляват с него акаунтите на собствените си клиенти. Не е необходимо да заявявате нищо и това не струва нищо допълнително.

Скриптът има точно същите права като Вас в DirectAdmin. Следователно той може да работи само с Вашия собствен пакет и само с нещата, които Вашият пакет позволява.

Как работи това

• Адрес: Вие комуникирате с API на същото място, където влизате: https://сървър:2222. Името на сървъра ще намерите в Моят WebOké при пакета, под Управление.
• Два вида команди: новото API, с адреси, започващи с /api/, и отговори в JSON, както и по-старото API с команди като /CMD_API_.... Започнете с новото API. Това, което все още не се съдържа там, ще намерите в старото API. Добавете там ?json=yes, за да получите отговор в JSON.
• Вход: всяка команда изпраща Вашето DA потребителско име и парола (HTTP Basic удостоверяване). За целта за предпочитане е да използвате ключ за вход (login key), а не истинската си DA парола, вижте по-долу.
• Документация в собствения Ви панел: в DirectAdmin ще намерите под Support & Help API Documentation. Там ще видите всички команди на новото API и можете веднага да ги изпробвате с Вашия собствен акаунт.

Пример

С тази команда заявявате базите данни на Вашия пакет. Заменете потребител, ключ и сървър с Вашите собствени данни:

curl -u 'потребител:ключ' https://сървър:2222/api/db-show/databases

Ще получите списък във формат JSON. По същия начин работи и от PHP, Python или всеки друг език, който може да заявява уеб адрес.

Безопасна работа с ключ за вход

Никога не давайте на скрипт обичайната си DA парола. Създайте в DirectAdmin при Login Keys отделен ключ. Такъв ключ можете да ограничите по следния начин:

• само командите, от които скриптът наистина се нуждае;
• само от IP адреса на компютъра или сървъра, на който работи скриптът;
• с дата на изтичане, ако имате нужда от достъп само за кратко.

Във всеки случай изключете командите CMD_LOGIN_KEYS и CMD_PASSWD, така че ключът да не може да създава нови ключове и да не може да променя Вашата парола. Ако въпреки това ключът изтече (бъде компрометиран), го изтрийте и създайте нов, без да се налага да променяте паролата си.

Как да създадете ключ, стъпка по стъпка е описано в ръководството за DirectAdmin: Login Keys: вход за скриптове и програми.

Полезно е да знаете

• Ако скрипт многократно се опитва да влезе с грешна парола или грешен ключ, нашият firewall блокира този IP адрес. Проверете на Блокиран ли съм?, ако Вашият скрипт внезапно спре да получава връзка.
• С удоволствие ще Ви помогнем, ако самото API не работи, но не пишем и не проверяваме собствени скриптове. За целта използвайте документацията на DirectAdmin по-долу.
• Предпочитате ли да управлявате хостинга си с Claude, ChatGPT или Mistral, без сами да програмирате? Разгледайте нашия MCP сървър за AI.

Документация на DirectAdmin

Документацията на DirectAdmin е на английски език:

• API Access: как работи API, влизане и различните видове API.
• Examples: примери с curl, Bash, PHP и Python.
• Legacy API: по-старите CMD_API команди и техните отговори.
• Преглед на CMD_API команди: търсене във всички по-стари команди.
• Creating a login key: ключове за вход според DirectAdmin.

Вижте също в ръководството за DirectAdmin: Намиране на името на Вашия сървър и DA потребителско име.