Die DirectAdmin-API verwenden: Ihr Paket mit Skripten verwalten

DirectAdmin verfügt über eine API: eine Möglichkeit, Ihr Paket mit einem Skript oder Programm zu verwalten, anstatt mit der Maus. Fast alles, was Sie im Panel tun, ist auch über die API möglich. Denken Sie an die Aktualisierung eines DNS-Eintrags, wenn sich Ihre IP-Adresse zu Hause ändert, das Anlegen von Postfächern aus Ihrer eigenen Software heraus oder das nächtliche Abrufen einer Liste Ihrer Datenbanken.

Kann ich die API mit meinem Paket nutzen?

Ja. Die API funktioniert mit jedem Paket, das DirectAdmin enthält: allen Webhosting-Paketen und auch den E-Mail-Paketen. Reseller können damit zusätzlich die Accounts ihrer eigenen Kunden verwalten. Sie müssen nichts beantragen, und es kostet nichts extra.

Ein Skript hat genau dieselben Rechte wie Sie in DirectAdmin. Es kann also nur auf Ihr eigenes Paket zugreifen, und nur auf das, was Ihr Paket zulässt.

Wie es funktioniert

• Adresse: Sie sprechen mit der API an derselben Stelle, an der Sie sich anmelden: https://servername:2222. Ihren Servernamen finden Sie in Mein WebOké beim Paket unter Verwalten.
• Zwei Arten von Befehlen: die neue API, mit Adressen, die mit /api/ beginnen, und Antworten in JSON, sowie die ältere API mit Befehlen wie /CMD_API_.... Beginnen Sie mit der neuen API. Was dort noch nicht vorhanden ist, finden Sie in der alten API. Fügen Sie dort ?json=yes hinzu, um eine Antwort in JSON zu erhalten.
• Anmeldung: Jeder Befehl sendet Ihren DA-Benutzernamen und ein Passwort mit (HTTP-Basisauthentifizierung). Verwenden Sie dafür vorzugsweise einen Anmeldeschlüssel (Login Key) und nicht Ihr echtes DA-Passwort, siehe unten.
• Dokumentation in Ihrem eigenen Panel: In DirectAdmin finden Sie unter Support & Help die API Documentation. Dort sehen Sie alle Befehle der neuen API und können diese sofort mit Ihrem eigenen Account ausprobieren.

Ein Beispiel

Mit diesem Befehl rufen Sie die Datenbanken Ihres Pakets ab. Ersetzen Sie benutzer, schluessel und servername durch Ihre eigenen Daten:

curl -u 'benutzer:schluessel' https://servername:2222/api/db-show/databases

Sie erhalten eine Liste in JSON zurück. Auf dieselbe Weise funktioniert es von PHP, Python oder jeder anderen Sprache aus, die eine Webadresse abrufen kann.

Sicher arbeiten mit einem Anmeldeschlüssel

Geben Sie einem Skript niemals Ihr gewöhnliches DA-Passwort. Erstellen Sie in DirectAdmin unter Anmeldeschlüssel einen separaten Schlüssel. Einen solchen Schlüssel können Sie einschränken auf:

• nur die Befehle, die das Skript tatsächlich benötigt;
• nur von der IP-Adresse des Computers oder Servers aus, auf dem das Skript läuft;
• mit einem Ablaufdatum, falls Sie den Zugang nur vorübergehend benötigen.

Schliessen Sie in jedem Fall die Befehle CMD_LOGIN_KEYS und CMD_PASSWD aus, damit der Schlüssel keine neuen Schlüssel erstellen und Ihr Passwort nicht ändern kann. Sollte der Schlüssel dennoch bekannt werden, löschen Sie ihn und erstellen Sie einen neuen, ohne dass Sie Ihr Passwort ändern müssen.

Wie Sie einen Schlüssel erstellen, finden Sie Schritt für Schritt in der DirectAdmin-Anleitung: Anmeldeschlüssel: Anmeldung für Skripte und Programme.

Gut zu wissen

• Versucht ein Skript häufig, sich mit einem falschen Passwort oder einem falschen Schlüssel anzumelden, blockiert unsere Firewall diese IP-Adresse. Schauen Sie auf Bin ich blockiert?, wenn Ihr Skript plötzlich keine Verbindung mehr bekommt.
• Wir helfen gerne, wenn die API selbst nicht funktioniert, aber wir schreiben oder überprüfen keine eigenen Skripte. Nutzen Sie dafür die Dokumentation von DirectAdmin weiter unten.
• Möchten Sie Ihr Hosting lieber mit Claude, ChatGPT oder Mistral verwalten, ohne selbst zu programmieren? Dann schauen Sie sich unseren MCP-Server für KI an.

Dokumentation von DirectAdmin

Die Dokumentation von DirectAdmin ist auf Englisch:

• API Access: wie die API funktioniert, Anmeldung und die verschiedenen Arten der API.
• Examples: Beispiele mit curl, Bash, PHP und Python.
• Legacy API: die älteren CMD_API-Befehle und ihre Antworten.
• Übersicht der CMD_API-Befehle: Suche in allen älteren Befehlen.
• Creating a login key: Anmeldeschlüssel laut DirectAdmin.

Siehe auch in der DirectAdmin-Anleitung: Ihren Servernamen und DA-Benutzernamen finden.