„DirectAdmin“ API naudojimas: valdykite savo paketą naudodami scenarijus

DirectAdmin turi API: tai būdas valdyti savo paketą naudojant scenarijų ar programą, o ne pelę. Beveik viską, ką galite atlikti skydelyje, galima padaryti ir per API. Pavyzdžiui, atnaujinti DNS įrašą, kai pasikeičia Jūsų namų IP adresas, kurti pašto dėžutes iš savo programinės įrangos arba kas naktį gauti savo duomenų bazių sąrašą.

Ar galiu naudoti API su savo paketu?

Taip. API veikia su kiekvienu paketu, kuriame yra DirectAdmin: visais svetainių prieglobos paketais ir taip pat e. pašto paketais. Be to, perpardavėjai (resellers) gali ja valdyti savo klientų paskyras. Jums nereikia nieko papildomai užsisakyti ir tai nieko nekainuoja.

Scenarijus turi lygiai tokias pačias teises, kokias turite Jūs DirectAdmin sistemoje. Taigi jis gali veikti tik su Jūsų paketu ir tik atlikti tai, ką leidžia Jūsų paketas.

Kaip tai veikia

• Adresas: su API susisiekiate toje pačioje vietoje, kur prisijungiate: https://serveris:2222. Serverio pavadinimą rasite Mano WebOké, prie paketo, skiltyje Valdyti.
• Dvi komandų rūšys: naujoji API, kurios adresai prasideda /api/ ir kurios atsakymai pateikiami JSON formatu, bei senesnioji API su tokiomis komandomis kaip /CMD_API_.... Pradėkite nuo naujosios API. Ko joje dar nėra, rasite senojoje API. Ten pridėkite ?json=yes, kad atsakymas būtų JSON formatu.
• Prisijungimas: kiekviena komanda siunčia Jūsų DA vartotojo vardą ir slaptažodį (HTTP Basic autentifikacija). Tam rekomenduojame naudoti prisijungimo raktą (login key), o ne tikrąjį DA slaptažodį, žr. žemiau.
• Dokumentacija Jūsų pačių skydelyje: DirectAdmin sistemoje, skiltyje Support & Help, rasite API Documentation. Ten matysite visas naujosios API komandas ir galėsite jas iškart išbandyti su savo paskyra.

Pavyzdys

Šia komanda gausite savo paketo duomenų bazių sąrašą. Pakeiskite vartotojas, raktas ir serveris savo duomenimis:

curl -u 'vartotojas:raktas' https://serveris:2222/api/db-show/databases

Gausite sąrašą JSON formatu. Tokiu pačiu būdu tai veikia naudojant PHP, Python ar bet kurią kitą kalbą, kuri gali kreiptis į interneto adresą.

Saugus darbas su prisijungimo raktu

Niekada nesuteikite scenarijui savo įprasto DA slaptažodžio. DirectAdmin sistemoje, skiltyje Prisijungimo raktai, susikurkite atskirą raktą. Tokį raktą galite apriboti:

• tik tomis komandomis, kurių scenarijui iš tiesų reikia;
• tik iš to kompiuterio ar serverio IP adreso, kuriame veikia scenarijus;
• nustatant galiojimo pabaigos datą, jei prieigos reikia tik trumpam.

Bet kuriuo atveju išjunkite komandas CMD_LOGIN_KEYS ir CMD_PASSWD, kad raktas negalėtų sukurti naujų raktų ir pakeisti Jūsų slaptažodžio. Jei raktas vis dėlto nutekėtų, jį ištrinsite ir susikursite naują, nekeisdami savo slaptažodžio.

Kaip sukurti raktą, žingsnis po žingsnio aprašyta DirectAdmin žinyne: Prisijungimo raktai: prisijungimas skriptams ir programoms.

Naudinga žinoti

• Jei scenarijus dažnai bando prisijungti su neteisingu slaptažodžiu ar raktu, mūsų ugniasienė užblokuoja tą IP adresą. Jei Jūsų scenarijus staiga nebegali prisijungti, žr. Ar esu užblokuotas?
• Mielai padėsime, jei pati API neveikia, tačiau mes nerašome ir netikriname Jūsų pačių scenarijų. Tam naudokitės žemiau pateikta DirectAdmin dokumentacija.
• Norite valdyti savo prieglobą su Claude, ChatGPT ar Mistral, patys neprogramuodami? Tuomet susipažinkite su mūsų MCP serveriu DI.

DirectAdmin dokumentacija

DirectAdmin dokumentacija pateikiama anglų kalba:

• API Access: kaip veikia API, prisijungimas ir skirtingi API tipai.
• Examples: pavyzdžiai su curl, Bash, PHP ir Python.
• Legacy API: senesnės CMD_API komandos ir jų atsakymai.
• CMD_API komandų apžvalga: visų senesnių komandų paieška.
• Creating a login key: prisijungimo raktai pagal DirectAdmin.

Taip pat žr. DirectAdmin žinyne: Serverio pavadinimo ir DA vartotojo vardo radimas.