Používání DirectAdmin API: správa Vašeho balíčku pomocí skriptů

DirectAdmin má API: způsob, jak spravovat svůj balíček pomocí skriptu nebo programu místo pomocí myši. Téměř vše, co děláte v panelu, lze provést i přes API. Můžete si tak například aktualizovat DNS záznam, když se Vám doma změní IP adresa, vytvářet e-mailové schránky z vlastního softwaru nebo si každou noc vyžádat seznam svých databází.

Mohu API používat se svým balíčkem?

Ano. API funguje s každým balíčkem, který obsahuje DirectAdmin: se všemi webhostingovými balíčky i s e-mailovými balíčky. Reselleři s ní navíc mohou spravovat účty svých vlastních klientů. Nic nemusíte žádat a nic to nestojí navíc.

Skript má přesně stejná práva jako Vy v DirectAdmin. Může tedy pracovat pouze s Vaším vlastním balíčkem, a pouze s těmi věcmi, které Váš balíček umožňuje.

Jak to funguje

• Adresa: s API komunikujete na stejném místě, kde se přihlašujete: https://nazevserveru:2222. Název serveru najdete v Můj WebOké u balíčku pod tlačítkem Spravovat.
• Dva typy příkazů: nová API, s adresami začínajícími na /api/ a odpověďmi ve formátu JSON, a starší API s příkazy jako /CMD_API_.... Začněte u nové API. Co v ní ještě chybí, najdete ve staré API. Tam za adresu přidejte ?json=yes pro odpověď ve formátu JSON.
• Přihlašování: každý příkaz odesílá Vaše DA uživatelské jméno a heslo (HTTP Basic autentizace). K tomu raději použijte přihlašovací klíč (login key), a ne své skutečné DA heslo, viz níže.
• Dokumentace přímo ve Vašem panelu: v DirectAdmin najdete pod Support & Help položku API Documentation. Tam uvidíte všechny příkazy nové API a můžete si je rovnou vyzkoušet s vlastním účtem.

Příklad

Tímto příkazem si vyžádáte databáze svého balíčku. Nahraďte uživatel, klíč a název serveru vlastními údaji:

curl -u 'uzivatel:klic' https://nazevserveru:2222/api/db-show/databases

Dostanete zpět seznam ve formátu JSON. Stejným způsobem to funguje i z PHP, Pythonu nebo jakéhokoli jiného jazyka, který umí vyžádat webovou adresu.

Bezpečná práce s přihlašovacím klíčem

Skriptu nikdy nedávejte své běžné DA heslo. V DirectAdmin si v sekci Přihlašovací klíče vytvořte samostatný klíč. Takový klíč můžete omezit:

• pouze na příkazy, které skript opravdu potřebuje;
• pouze na IP adresu počítače nebo serveru, na kterém skript běží;
• datem vypršení platnosti, pokud přístup potřebujete jen na krátkou dobu.

V každém případě vylučte příkazy CMD_LOGIN_KEYS a CMD_PASSWD, aby klíč nemohl vytvářet nové klíče a nemohl měnit Vaše heslo. Pokud přesto klíč unikne, jednoduše ho smažte a vytvořte nový, aniž byste museli měnit heslo.

Jak klíč vytvořit, najdete krok za krokem v návodu DirectAdmin: Přihlašovací klíče: přihlašování pro skripty a programy.

Dobré vědět

• Pokud se skript opakovaně pokouší přihlásit se špatným heslem nebo špatným klíčem, náš firewall danou IP adresu zablokuje. Pokud Váš skript náhle přestane navazovat spojení, podívejte se na stránku Je moje IP adresa zablokovaná?.
• Rádi pomůžeme, pokud samotné API nefunguje, ale vlastní skripty nepíšeme ani nekontrolujeme. Použijte k tomu dokumentaci DirectAdmin níže.
• Chcete svůj hosting raději spravovat pomocí Claude, ChatGPT nebo Mistral, bez vlastního programování? Podívejte se na náš MCP server pro AI.

Dokumentace DirectAdmin

Dokumentace DirectAdmin je v angličtině:

• API Access: jak API funguje, přihlašování a různé typy API.
• Examples: příklady s curl, Bash, PHP a Python.
• Legacy API: starší příkazy CMD_API a jejich odpovědi.
• Přehled příkazů CMD_API: vyhledávání ve všech starších příkazech.
• Creating a login key: přihlašovací klíče podle DirectAdmin.

Viz také v návodu DirectAdmin: Jak najít název serveru a DA uživatelské jméno.