DirectAdmin API izmantošana: Jūsu pakotnes pārvaldība ar skriptiem

DirectAdmin ir aprīkots ar API: veidu, kā pārvaldīt Jūsu pakotni, izmantojot skriptu vai programmu, nevis peli. Gandrīz visu, ko varat darīt panelī, varat izdarīt arī ar API palīdzību. Piemēram, atjaunināt DNS ierakstu, ja mainās Jūsu IP adrese mājās, izveidot pastkastes no savas programmatūras vai katru nakti pieprasīt savu datubāzu sarakstu.

Vai varu izmantot API ar savu pakotni?

Jā. API darbojas ar jebkuru pakotni, kurā ir iekļauts DirectAdmin: visām tīmekļa hostinga pakotnēm, kā arī e-pasta pakotnēm. Tālākpārdevēji var ar to pārvaldīt arī savu klientu kontus. Jums nekas nav jāpieprasa un tas nemaksā papildus.

Skriptam ir tieši tādas pašas tiesības, kādas Jums ir DirectAdmin. Tātad tas var darboties tikai ar Jūsu pašu pakotni un tikai tajos ietvaros, ko Jūsu pakotne pieļauj.

Kā tas darbojas

• Adrese: Jūs sazināties ar API tajā pašā vietā, kur Jūs piesakāties: https://serveris:2222. Jūsu servera nosaukumu varat atrast sadaļā Mans WebOké pie pakotnes zem Pārvaldīt.
• Divi komandu veidi: jaunā API, kuras adreses sākas ar /api/ un atbildes ir JSON formātā, un vecākā API ar komandām, piemēram, /CMD_API_.... Sāciet ar jauno API. To, kā tur vēl nav, atradīsiet vecajā API. Pievienojiet tai ?json=yes, lai saņemtu atbildi JSON formātā.
• Pieteikšanās: katra komanda nosūta Jūsu DA lietotājvārdu un paroli (HTTP Basic autentifikācija). Ieteicams šim nolūkam izmantot pieteikšanās atslēgu (login key), nevis savu īsto DA paroli, skatiet zemāk.
• Dokumentācija Jūsu pašu panelī: DirectAdmin sadaļā Support & Help atradīsiet API Documentation. Tur redzēsiet visas jaunās API komandas un varat tās uzreiz izmēģināt ar savu kontu.

Piemērs

Ar šo komandu varat pieprasīt Jūsu pakotnes datubāzes. Aizstājiet lietotajs, atslega un serveris ar saviem datiem:

curl -u 'lietotajs:atslega' https://serveris:2222/api/db-show/databases

Jūs saņemsiet sarakstu JSON formātā. Tāpat tas darbojas arī no PHP, Python vai jebkuras citas valodas, kas spēj pieprasīt tīmekļa adresi.

Droša darbība ar pieteikšanās atslēgu

Nekad nedodiet skriptam savu parasto DA paroli. DirectAdmin sadaļā Login Keys izveidojiet atsevišķu atslēgu. Šādu atslēgu varat ierobežot:

• tikai ar tām komandām, kas skriptam patiešām ir nepieciešamas;
• tikai no tā datora vai servera IP adreses, uz kura skripts darbojas;
• ar derīguma termiņu, ja piekļuve nepieciešama tikai īslaicīgi.

Noteikti izslēdziet komandas CMD_LOGIN_KEYS un CMD_PASSWD, lai atslēga nevarētu izveidot jaunas atslēgas un nevarētu mainīt Jūsu paroli. Ja atslēga tomēr nonāk nepareizās rokās, dzēsiet to un izveidojiet jaunu, nemainot savu paroli.

Kā izveidot atslēgu, soli pa solim ir aprakstīts DirectAdmin rokasgrāmatā: Login Keys: pieteikšanās skriptiem un programmām.

Noderīga informācija

• Ja skripts vairākkārt mēģina pieteikties ar nepareizu paroli vai nepareizu atslēgu, mūsu ugunsmūris bloķē šo IP adresi. Apmeklējiet Vai mana IP adrese ir bloķēta?, ja Jūsu skripts pēkšņi vairs nevar izveidot savienojumu.
• Mēs labprāt palīdzam, ja pati API nedarbojas, taču mēs neveidojam un nepārbaudām pašrakstītus skriptus. Šim nolūkam izmantojiet DirectAdmin dokumentāciju, kas norādīta zemāk.
• Vai vēlaties pārvaldīt savu hostingu, izmantojot Claude, ChatGPT vai Mistral, pašiem neprogrammējot? Apskatiet mūsu MCP serveri MI.

DirectAdmin dokumentācija

DirectAdmin dokumentācija ir pieejama angļu valodā:

• API Access: kā darbojas API, pieteikšanās un dažādie API veidi.
• Examples: piemēri ar curl, Bash, PHP un Python.
• Legacy API: vecākās CMD_API komandas un to atbildes.
• CMD_API komandu pārskats: meklēšana visās vecākajās komandās.
• Creating a login key: pieteikšanās atslēgas saskaņā ar DirectAdmin.

Skatiet arī DirectAdmin rokasgrāmatā: Jūsu servera nosaukuma un DA lietotājvārda atrašana.