DirectAdmini API kasutamine: oma paketi haldamine skriptidega

DirectAdminil on API: võimalus hallata oma paketti skripti või programmi abil, mitte hiirega klikkides. Peaaegu kõike, mida saad teha paneelis, saab teha ka API kaudu. Mõtle näiteks DNS-kirje uuendamisele, kui su kodune IP-aadress muutub, postkastide loomisele oma tarkvarast või iga öö oma andmebaaside nimekirja küsimisele.

Kas saan API-t kasutada oma paketiga?

Jah. API töötab iga paketiga, kus on DirectAdmin: kõigi veebimajutuspakettide ja ka e-posti pakettidega. Edasimüüjad saavad lisaks hallata sellega oma klientide kontosid. Sul ei ole vaja midagi taotleda ja see ei maksa lisaks midagi.

Skriptil on täpselt samad õigused, mis sinul DirectAdminis. See saab seega tegutseda ainult su enda paketiga ja ainult teha asju, mida su pakett lubab.

Kuidas see toimib

• Aadress: suhtled API-ga samas kohas, kus sisse logid: https://servernimi:2222. Oma servernime leiad Minu WebOké-st paketi juures nupu Halda all.
• Kaks käsurühma: uus API, mille aadressid algavad tähistega /api/ ja vastused on JSON-vormingus, ning vanem API käskudega nagu /CMD_API_.... Alusta uuest API-st. Mida seal veel ei ole, leiad vanast API-st. Lisa sinna taha ?json=yes, et saada vastus JSON-vormingus.
• Sisselogimine: iga käsk saadab kaasa su DA kasutajanime ja parooli (HTTP Basic-autentimine). Kasuta selleks eelistatavalt aanmelduse võtit (login key), mitte oma tegelikku DA parooli, vaata allpool.
• Dokumentatsioon su enda paneelis: DirectAdminis leiad menüüst Support & Help valiku API Documentation. Seal näed kõiki uue API käske ja saad neid kohe oma kontoga proovida.

Üks näide

Selle käsuga küsid oma paketi andmebaase. Asenda kasutaja, võti ja servernimi enda andmetega:

curl -u 'kasutaja:voti' https://servernimi:2222/api/db-show/databases

Vastuseks saad nimekirja JSON-vormingus. Samamoodi toimib see ka PHP-st, Pythonist või mis tahes muust keelest, mis oskab veebiaadressi küsida.

Turvaline töötamine aanmelduse võtmega

Ära kunagi anna skriptile oma tavalist DA parooli. Loo DirectAdminis menüüs Aanmelduse võtmed eraldi võti. Sellist võtit saad piirata:

• ainult nende käskudega, mida skript tegelikult vajab;
• ainult selle arvuti või serveri IP-aadressilt, kus skript töötab;
• aegumiskuupäevaga, kui vajad ligipääsu ainult lühikest aega.

Igal juhul jäta välja käsud CMD_LOGIN_KEYS ja CMD_PASSWD, et võti ei saaks luua uusi võtmeid ega muuta su parooli. Kui võti siiski lekib, kustuta see ja loo uus, ilma et peaksid oma parooli muutma.

Kuidas võtit luua, on samm-sammult kirjas DirectAdmini käsiraamatus: Aanmelduse võtmed: sisselogimine skriptide ja programmide jaoks.

Hea teada

• Kui skript proovib korduvalt valesti parooli või vale võtmega sisse logida, blokeerib meie tulemüür selle IP-aadressi. Vaata Kas olen blokeeritud?, kui su skript ei saa enam ühendust.
• Aitame hea meelega, kui API ise ei tööta, kuid me ei kirjuta ega kontrolli ise skripte. Kasuta selleks DirectAdmini dokumentatsiooni allpool.
• Kas sooviksid oma majutust hallata hoopis Claude, ChatGPT või Mistraliga, ise programmeerimata? Vaata siis meie MCP-serverit tehisintellektile.

DirectAdmini dokumentatsioon

DirectAdmini dokumentatsioon on inglise keeles:

• API Access: kuidas API töötab, sisselogimine ja erinevad API tüübid.
• Examples: näited curl, Bash, PHP ja Pythoniga.
• Legacy API: vanemad CMD_API käsud ja nende vastused.
• CMD_API käskude ülevaade: kõigi vanemate käskude otsing.
• Creating a login key: aanmeldusvõtmed DirectAdmini kirjelduse järgi.

Vaata ka DirectAdmini käsiraamatust: Oma servernime ja DA kasutajanime leidmine.