Bruke DirectAdmin-APIet: administrer pakken din med skript

DirectAdmin har et API: en måte å administrere pakken din med et skript eller program i stedet for med musen. Nesten alt du gjør i panelet, kan også gjøres via API-et. Tenk på å oppdatere en DNS-post når IP-adressen hjemme endrer seg, opprette postbokser fra din egen programvare eller hente en liste over databasene dine hver natt.

Kan jeg bruke API-et med pakken min?

Ja. API-et fungerer med alle pakker som har DirectAdmin: alle webhotellpakker og også e-postpakkene. Forhandlere kan i tillegg bruke det til å administrere kontoene til sine egne kunder. Du trenger ikke søke om noe, og det koster ingenting ekstra.

Et skript har nøyaktig de samme rettighetene som deg i DirectAdmin. Det kan altså bare brukes på din egen pakke, og bare til det pakken din tillater.

Slik henger det sammen

• Adresse: du snakker med API-et på samme sted som du logger inn: https://servernavn:2222. Servernavnet finner du i Min side ved pakken under Administrer.
• To typer kommandoer: det nye API-et, med adresser som starter med /api/ og svar i JSON, og det eldre API-et med kommandoer som /CMD_API_.... Begynn med det nye API-et. Det som ikke finnes der ennå, finner du i det gamle API-et. Legg til ?json=yes bak for et svar i JSON.
• Innlogging: hver kommando sender med ditt DA-brukernavn og et passord (HTTP Basic-autentisering). Bruk helst en innloggingsnøkkel (login key) til dette, og ikke ditt ekte DA-passord, se nedenfor.
• Dokumentasjon i ditt eget panel: i DirectAdmin finner du under Support & Help API Documentation. Der ser du alle kommandoene i det nye API-et og kan prøve dem med en gang med din egen konto.

Et eksempel

Med denne kommandoen henter du databasene til pakken din. Erstatt bruker, nøkkel og servernavn med dine egne opplysninger:

curl -u 'bruker:nøkkel' https://servernavn:2222/api/db-show/databases

Du får en liste i JSON tilbake. På samme måte fungerer det fra PHP, Python eller ethvert annet språk som kan hente en nettadresse.

Trygt arbeid med en innloggingsnøkkel

Gi aldri et skript ditt vanlige DA-passord. Opprett en egen nøkkel i DirectAdmin under Innloggingsnøkler. En slik nøkkel kan du begrense:

• bare de kommandoene skriptet faktisk trenger;
• bare fra IP-adressen til datamaskinen eller serveren der skriptet kjører;
• med en utløpsdato, hvis du bare trenger tilgangen en kort stund.

Ekskluder i alle tilfeller kommandoene CMD_LOGIN_KEYS og CMD_PASSWD, slik at nøkkelen ikke kan lage nye nøkler og ikke kan endre passordet ditt. Hvis nøkkelen likevel lekker ut, fjerner du den og lager en ny, uten å måtte endre passordet ditt.

Hvordan du lager en nøkkel, står steg for steg i DirectAdmin-håndboken: Innloggingsnøkler: innlogging for skript og programmer.

Greit å vite

• Prøver et skript ofte å logge inn med feil passord eller feil nøkkel, blokkerer brannmuren vår den IP-adressen. Se på Er jeg blokkert? hvis skriptet ditt plutselig ikke får kontakt lenger.
• Vi hjelper gjerne hvis selve API-et ikke fungerer, men vi skriver eller kontrollerer ikke egne skript. Bruk dokumentasjonen fra DirectAdmin nedenfor til dette.
• Vil du heller administrere hostingen din med Claude, ChatGPT eller Mistral, uten å programmere selv? Se da vår MCP-server for KI.

Dokumentasjon fra DirectAdmin

Dokumentasjonen fra DirectAdmin er på engelsk:

• API Access: hvordan API-et fungerer, innlogging og de ulike typene API.
• Examples: eksempler med curl, Bash, PHP og Python.
• Legacy API: de eldre CMD_API-kommandoene og svarene deres.
• Oversikt over CMD_API-kommandoer: søk blant alle eldre kommandoer.
• Creating a login key: innloggingsnøkler ifølge DirectAdmin.

Se også i DirectAdmin-håndboken: Finn servernavnet og DA-brukernavnet ditt.