DirectAdmin-API:n käyttäminen: pakettisi hallinta skripteillä

DirectAdmin-paneelissa on API: tapa hallita pakettiasi skriptillä tai ohjelmalla hiiren sijaan. Lähes kaiken, mitä teet paneelissa, voi tehdä myös API:n kautta. Esimerkiksi DNS-tietueen päivittäminen, kun kotisi IP-osoite muuttuu, postilaatikoiden luominen omasta ohjelmistostasi tai tietokantojesi listan hakeminen joka yö.

Voinko käyttää API:a pakettini kanssa?

Kyllä. API toimii jokaisen paketin kanssa, jossa on DirectAdmin: kaikki webhotellipaketit ja myös sähköpostipaketit. Jälleenmyyjät voivat lisäksi hallita sillä omien asiakkaidensa tilejä. Sinun ei tarvitse pyytää mitään, eikä se maksa mitään lisää.

Skriptillä on täsmälleen samat oikeudet kuin sinulla DirectAdminissa. Se toimii siis vain omassa paketissasi, ja vain niiden asioiden kanssa, jotka pakettisi sallii.

Näin se toimii

• Osoite: olet yhteydessä API:in samassa paikassa, josta kirjaudut sisään: https://palvelimennimi:2222. Palvelimennimen löydät Oma WebOké palvelusta paketin kohdalta Hallitse.
• Kaksi komentotyyppiä: uusi API, jonka osoitteet alkavat merkinnällä /api/ ja jonka vastaukset ovat JSON-muodossa, sekä vanhempi API, jonka komennot ovat muotoa /CMD_API_.... Aloita uudesta API:sta. Mitä siitä vielä puuttuu, löydät vanhasta API:sta. Lisää sen perään ?json=yes, niin saat vastauksen JSON-muodossa.
• Kirjautuminen: jokainen komento lähettää mukana DA-käyttäjätunnuksesi ja salasanan (HTTP Basic -todennus). Käytä mieluummin login key -avainta kuin oikeaa DA-salasanaasi, katso alta.
• Dokumentaatio omassa paneelissasi: DirectAdminissa löydät kohdasta Support & Help kohdan API Documentation. Siellä näet kaikki uuden API:n komennot ja voit kokeilla niitä heti omalla tililläsi.

Esimerkki

Tällä komennolla haet pakettisi tietokannat. Korvaa käyttäjä, avain ja palvelimennimi omilla tiedoillasi:

curl -u 'käyttäjä:avain' https://palvelimennimi:2222/api/db-show/databases

Saat vastaukseksi listan JSON-muodossa. Samalla tavalla se toimii PHP:stä, Pythonista tai mistä tahansa muusta kielestä, joka pystyy hakemaan verkko-osoitteen.

Turvallinen työskentely Login Key -avaimella

Älä koskaan anna skriptille tavallista DA-salasanaasi. Luo DirectAdminissa kohdassa Login Keys erillinen avain. Tällaista avainta voit rajoittaa:

• vain niihin komentoihin, joita skripti todella tarvitsee;
• vain sen tietokoneen tai palvelimen IP-osoitteesta, jolla skripti toimii;
• vanhenemispäivällä, jos tarvitset käyttöoikeutta vain hetken.

Sulje joka tapauksessa pois komennot CMD_LOGIN_KEYS ja CMD_PASSWD, jotta avain ei voi luoda uusia avaimia eikä muuttaa salasanaasi. Jos avain kuitenkin vuotaa, poista se ja luo uusi, ilman että sinun tarvitsee vaihtaa salasanaasi.

Miten luot avaimen, löytyy vaihe vaiheelta DirectAdmin-käyttöoppaasta: Login Keys: kirjautuminen skripteille ja ohjelmille.

Hyvä tietää

• Jos skripti yrittää usein kirjautua väärällä salasanalla tai väärällä avaimella, palomuurimme estää kyseisen IP-osoitteen. Katso sivulta Olenko estetty?, jos skriptisi ei yhtäkkiä saa enää yhteyttä.
• Autamme mielellämme, jos itse API ei toimi, mutta emme kirjoita emmekä tarkista omia skriptejä. Käytä siihen DirectAdminin dokumentaatiota alla.
• Haluatko mieluummin hallita hosting-palveluasi Claudella, ChatGPT:llä tai Mistralilla, ohjelmoimatta itse? Tutustu silloin MCP-palvelimeemme tekoälylle.

DirectAdminin dokumentaatio

DirectAdminin dokumentaatio on englanniksi:

• API Access: miten API toimii, kirjautuminen ja API:n eri tyypit.
• Examples: esimerkkejä curlilla, Bashilla, PHP:llä ja Pythonilla.
• Legacy API: vanhemmat CMD_API-komennot ja niiden vastaukset.
• Yhteenveto CMD_API-komennoista: kaikkien vanhempien komentojen hakeminen.
• Creating a login key: login key -avaimet DirectAdminin mukaan.

Katso myös DirectAdmin-käyttöoppaasta: Palvelimennimen ja DA-käyttäjätunnuksen löytäminen.