Používanie DirectAdmin API: spravujte váš balík pomocou skriptov

DirectAdmin má API: spôsob, ako spravovať váš balík pomocou skriptu alebo programu namiesto myši. Takmer všetko, čo robíte v paneli, môžete urobiť aj prostredníctvom API. Napríklad aktualizovať DNS záznam, keď sa zmení vaša domáca IP adresa, vytvárať poštové schránky z vlastného softvéru alebo si každú noc vyžiadať zoznam vašich databáz.

Môžem použiť API s mojím balíkom?

Áno. API funguje s každým balíkom, ktorý obsahuje DirectAdmin: všetky webhostingové balíky a aj e-mailové balíky. Reselleri okrem toho môžu pomocou neho spravovať účty svojich vlastných klientov. Nemusíte nič žiadať a nič to nestojí navyše.

Skript má presne rovnaké práva ako vy v DirectAdmin. Môže teda pracovať iba s vaším vlastným balíkom a iba s vecami, ktoré váš balík umožňuje.

Ako to funguje

• Adresa: s API komunikujete na rovnakom mieste, na ktorom sa prihlasujete: https://názovservera:2222. Váš názov servera nájdete v Môj WebOké pri balíku pod Spravovať.
• Dva druhy príkazov: nová API s adresami, ktoré začínajú na /api/ a odpoveďami vo formáte JSON, a staršia API s príkazmi ako /CMD_API_.... Začnite s novou API. Čo v nej ešte nie je, nájdete v starej API. Pridajte za ňu ?json=yes pre odpoveď vo formáte JSON.
• Prihlásenie: každý príkaz odosiela vaše DA používateľské meno a heslo (HTTP Basic autentifikácia). Na to použite radšej prihlasovací kľúč (login key), a nie vaše skutočné DA heslo, pozrite nižšie.
• Dokumentácia vo vlastnom paneli: v DirectAdmin nájdete pod Support & Help položku API Documentation. Tam nájdete všetky príkazy novej API a môžete ich hneď vyskúšať s vlastným účtom.

Príklad

Týmto príkazom si vyžiadate databázy vášho balíka. Nahraďte používateľ, kľúč a názov servera vlastnými údajmi:

curl -u 'pouzivatel:kluc' https://nazovservera:2222/api/db-show/databases

Dostanete späť zoznam vo formáte JSON. Rovnakým spôsobom to funguje z PHP, Python alebo akéhokoľvek iného jazyka, ktorý dokáže vyžiadať webovú adresu.

Bezpečná práca s prihlasovacím kľúčom

Skriptu nikdy nedávajte svoje bežné DA heslo. V DirectAdmin v časti Prihlasovacie kľúče vytvorte samostatný kľúč. Takýto kľúč môžete obmedziť:

• iba na príkazy, ktoré skript naozaj potrebuje;
• iba z IP adresy počítača alebo servera, na ktorom skript beží;
• s dátumom expirácie, ak prístup potrebujete iba na krátky čas.

V každom prípade vylúčte príkazy CMD_LOGIN_KEYS a CMD_PASSWD, aby kľúč nemohol vytvárať nové kľúče a meniť vaše heslo. Ak sa kľúč napriek tomu dostane von, jednoducho ho odstráňte a vytvorte nový, bez toho, aby ste museli meniť heslo.

Ako vytvoriť kľúč, nájdete krok za krokom v návode pre DirectAdmin: Prihlasovacie kľúče: prihlasovanie pre skripty a programy.

Dobré vedieť

• Ak sa skript opakovane pokúša prihlásiť s nesprávnym heslom alebo nesprávnym kľúčom, náš firewall danú IP adresu zablokuje. Ak váš skript zrazu prestane mať pripojenie, pozrite si Je moja IP adresa zablokovaná?.
• Radi pomôžeme, ak samotné API nefunguje, ale vlastné skripty nepíšeme ani nekontrolujeme. Na to použite dokumentáciu DirectAdmin nižšie.
• Chcete radšej spravovať svoj hosting pomocou Claude, ChatGPT alebo Mistral, bez vlastného programovania? Pozrite si náš MCP server pre AI.

Dokumentácia DirectAdmin

Dokumentácia DirectAdmin je v angličtine:

• API Access: ako funguje API, prihlasovanie a rôzne druhy API.
• Examples: príklady s curl, Bash, PHP a Python.
• Legacy API: staršie príkazy CMD_API a ich odpovede.
• Prehľad príkazov CMD_API: vyhľadávanie vo všetkých starších príkazoch.
• Creating a login key: prihlasovacie kľúče podľa DirectAdmin.

Pozrite si tiež v návode pre DirectAdmin: Ako nájsť názov servera a DA používateľské meno.