Sådan bruger du DirectAdmin-API'en: administrer din pakke med scripts

DirectAdmin har en API: en måde at administrere din pakke med et script eller program i stedet for med musen. Næsten alt, hvad du gør i panelet, kan også gøres via API'en. Tænk på at opdatere en DNS-post, når din IP-adresse derhjemme ændrer sig, oprette mailbokse fra din egen software eller hente en liste over dine databaser hver nat.

Kan jeg bruge API'en med min pakke?

Ja. API'en fungerer med alle pakker, der inkluderer DirectAdmin: alle webhostingpakker og også e-mailpakkerne. Resellere kan derudover bruge den til at administrere deres egne kunders konti. Du behøver ikke at ansøge om noget, og det koster ikke ekstra.

Et script har præcis de samme rettigheder som dig i DirectAdmin. Det kan derfor kun arbejde med din egen pakke, og kun de ting, din pakke tillader.

Sådan fungerer det

• Adresse: du kommunikerer med API'en samme sted, som du logger ind: https://servernavn:2222. Du finder dit servernavn i Mit WebOké ved pakken under Administrer.
• To slags kommandoer: den nye API, med adresser der begynder med /api/ og svar i JSON, og den ældre API med kommandoer som /CMD_API_.... Begynd med den nye API. Det, der endnu ikke findes der, finder du i den gamle API. Tilføj ?json=yes bagefter for et svar i JSON.
• Login: hver kommando sender dit DA-brugernavn og en adgangskode med (HTTP Basic-godkendelse). Brug til dette fortrinsvis en login-nøgle og ikke din rigtige DA-adgangskode, se nedenfor.
• Dokumentation i dit eget panel: i DirectAdmin finder du under Support & Help API Documentation. Der kan du se alle kommandoer i den nye API og prøve dem med det samme med din egen konto.

Et eksempel

Med denne kommando henter du databaserne for din pakke. Erstat bruger, nøgle og servernavn med dine egne oplysninger:

curl -u 'bruger:nøgle' https://servernavn:2222/api/db-show/databases

Du får en liste i JSON tilbage. På samme måde fungerer det fra PHP, Python eller ethvert andet sprog, der kan hente en webadresse.

Sikkert arbejde med en login-nøgle

Giv aldrig et script din almindelige DA-adgangskode. Opret i DirectAdmin under Login-nøgler en separat nøgle. Sådan en nøgle kan du begrænse:

• kun til de kommandoer, scriptet rent faktisk har brug for;
• kun fra IP-adressen på den computer eller server, hvor scriptet kører;
• med en udløbsdato, hvis du kun har brug for adgangen i kort tid.

Udeluk under alle omstændigheder kommandoerne CMD_LOGIN_KEYS og CMD_PASSWD, så nøglen ikke kan oprette nye nøgler og ikke kan ændre din adgangskode. Hvis nøglen alligevel bliver lækket, sletter du den og opretter en ny, uden at du behøver at ændre din adgangskode.

Hvordan du opretter en nøgle, trin for trin, finder du i DirectAdmin-vejledningen: Login-nøgler: log ind til scripts og programmer.

Godt at vide

• Hvis et script ofte forsøger at logge ind med en forkert adgangskode eller en forkert nøgle, blokerer vores firewall den pågældende IP-adresse. Se Er jeg blokeret?, hvis dit script pludselig ikke kan oprette forbindelse mere.
• Vi hjælper gerne, hvis API'en selv ikke virker, men vi skriver eller kontrollerer ikke dine egne scripts. Brug i stedet dokumentationen fra DirectAdmin nedenfor.
• Vil du hellere administrere din hosting med Claude, ChatGPT eller Mistral uden selv at programmere? Så kig på vores MCP-server til AI.

DirectAdmin-dokumentation

Dokumentationen fra DirectAdmin er på engelsk:

• API Access: hvordan API'en fungerer, login og de forskellige typer API.
• Examples: eksempler med curl, Bash, PHP og Python.
• Legacy API: de ældre CMD_API-kommandoer og deres svar.
• Oversigt over CMD_API-kommandoer: søg i alle ældre kommandoer.
• Creating a login key: login-nøgler ifølge DirectAdmin.

Se også i DirectAdmin-vejledningen: Find dit servernavn og DA-brugernavn.