Använda DirectAdmin-API:et: hantera ditt paket med skript

DirectAdmin har ett API: ett sätt att hantera ditt paket med ett skript eller program istället för med musen. Nästan allt du gör i panelen kan också göras via API:et. Tänk på att uppdatera en DNS-post när din IP-adress hemma ändras, skapa e-postkonton från din egen programvara eller hämta en lista över dina databaser varje natt.

Kan jag använda API:et med mitt paket?

Ja. API:et fungerar med alla paket som innehåller DirectAdmin: alla webbhotellpaket och även e-postpaketen. Återförsäljare kan dessutom använda det för att hantera sina egna kunders konton. Du behöver inte ansöka om något och det kostar inget extra.

Ett skript har exakt samma rättigheter som du i DirectAdmin. Det kan alltså bara komma åt ditt eget paket, och bara det som ditt paket tillåter.

Så fungerar det

• Adress: du pratar med API:et på samma plats som där du loggar in: https://servernamn:2222. Ditt servernamn hittar du i Mitt WebOké vid paketet under Hantera.
• Två typer av kommandon: det nya API:et, med adresser som börjar med /api/ och svar i JSON, och det äldre API:et med kommandon som /CMD_API_.... Börja med det nya API:et. Det som inte finns där hittar du i det gamla API:et. Lägg till ?json=yes efter för ett svar i JSON.
• Inloggning: varje kommando skickar med ditt DA-användarnamn och ett lösenord (HTTP Basic-autentisering). Använd helst en inloggningsnyckel (login key) för detta och inte ditt riktiga DA-lösenord, se nedan.
• Dokumentation i din egen panel: i DirectAdmin hittar du under Support & Help API Documentation. Där ser du alla kommandon i det nya API:et och kan testa dem direkt med ditt eget konto.

Ett exempel

Med det här kommandot hämtar du databaserna för ditt paket. Ersätt användare, nyckel och servernamn med dina egna uppgifter:

curl -u 'användare:nyckel' https://servernamn:2222/api/db-show/databases

Du får en lista i JSON tillbaka. På samma sätt fungerar det från PHP, Python eller något annat språk som kan hämta en webbadress.

Arbeta säkert med en inloggningsnyckel

Ge aldrig ett skript ditt vanliga DA-lösenord. Skapa en separat nyckel i DirectAdmin under Inloggningsnycklar. En sådan nyckel kan du begränsa:

• till bara de kommandon som skriptet verkligen behöver;
• till bara IP-adressen för datorn eller servern där skriptet körs;
• med ett utgångsdatum, om du bara behöver tillgången en kort tid.

Uteslut i vilket fall kommandona CMD_LOGIN_KEYS och CMD_PASSWD, så att nyckeln inte kan skapa nya nycklar och inte kan ändra ditt lösenord. Om nyckeln ändå läcker ut tar du bort den och skapar en ny, utan att behöva ändra ditt lösenord.

Hur du skapar en nyckel finns steg för steg i DirectAdmin-handledningen: Inloggningsnycklar: logga in för skript och program.

Bra att veta

• Om ett skript ofta försöker logga in med fel lösenord eller fel nyckel blockerar vår brandvägg den IP-adressen. Kolla på Är jag blockerad? om ditt skript plötsligt inte längre kan ansluta.
• Vi hjälper gärna till om själva API:et inte fungerar, men vi skriver eller kontrollerar inte egna skript. Använd DirectAdmins dokumentation nedan för det.
• Vill du hellre hantera ditt webbhotell med Claude, ChatGPT eller Mistral, utan att programmera själv? Ta då en titt på vår MCP-server för AI.

DirectAdmins dokumentation

DirectAdmins dokumentation är på engelska:

• API Access: hur API:et fungerar, inloggning och de olika typerna av API.
• Examples: exempel med curl, Bash, PHP och Python.
• Legacy API: de äldre CMD_API-kommandona och deras svar.
• Översikt över CMD_API-kommandon: sök bland alla äldre kommandon.
• Creating a login key: inloggningsnycklar enligt DirectAdmin.

Se även i DirectAdmin-handledningen: Hitta ditt servernamn och DA-användarnamn.