Uporaba vmesnika DirectAdmin API: upravljanje Vašega paketa s skripti

DirectAdmin ima API: način za upravljanje Vašega paketa s skripto ali programom namesto z miško. Skoraj vse, kar lahko naredite v nadzorni plošči, je mogoče narediti tudi prek API-ja. Pomislite na posodobitev zapisa DNS, ko se spremeni Vaš domači naslov IP, ustvarjanje poštnih predalov iz Vaše lastne programske opreme ali vsako noč pridobivanje seznama Vaših podatkovnih zbirk.

Ali lahko API uporabljam s svojim paketom?

Da. API deluje z vsakim paketom, ki vključuje DirectAdmin: vsemi paketi spletnega gostovanja in tudi paketi e-pošte. Preprodajalci lahko poleg tega z njim upravljajo tudi račune svojih lastnih strank. Ničesar Vam ni treba zahtevati in to ne stane nič dodatnega.

Skripta ima natanko enake pravice, kot jih imate Vi v DirectAdmin. Lahko torej dostopa samo do Vašega lastnega paketa in samo do stvari, ki jih Vaš paket dovoljuje.

Kako je to zgrajeno

• Naslov: z API-jem komunicirate na istem mestu, kjer se prijavljate: https://imestreznika:2222. Ime strežnika najdete v Moj WebOké pri paketu pod Upravljaj.
• Dve vrsti ukazov: novi API, z naslovi, ki se začnejo z /api/, in odgovori v obliki JSON, ter starejši API z ukazi, kot je /CMD_API_.... Začnite z novim API-jem. Kar tam še ni na voljo, najdete v starem API-ju. Za odgovor v obliki JSON temu dodajte ?json=yes.
• Prijava: vsak ukaz skupaj pošlje Vaše uporabniško ime DA in geslo (preverjanje pristnosti HTTP Basic). Za to raje uporabite prijavni ključ (login key) in ne svojega pravega gesla DA, glejte spodaj.
• Dokumentacija v Vaši lastni nadzorni plošči: v DirectAdmin pod Support & Help najdete API Documentation. Tam si lahko ogledate vse ukaze novega API-ja in jih takoj preizkusite s svojim lastnim računom.

Primer

S tem ukazom pridobite podatkovne zbirke svojega paketa. Zamenjajte uporabnik, ključ in ime strežnika s svojimi lastnimi podatki:

curl -u 'uporabnik:kljuc' https://imestreznika:2222/api/db-show/databases

Nazaj dobite seznam v obliki JSON. Enako deluje tudi iz PHP, Python ali katerega koli drugega jezika, ki lahko pridobi spletni naslov.

Varno delo s prijavnim ključem

Skripti nikoli ne dajte svojega običajnega gesla DA. V DirectAdmin pri Prijavni ključi ustvarite ločen ključ. Tak ključ lahko omejite:

• samo na ukaze, ki jih skripta dejansko potrebuje;
• samo na naslov IP računalnika ali strežnika, na katerem skripta deluje;
• z datumom poteka, če dostop potrebujete le za kratek čas.

Vsekakor izključite ukaza CMD_LOGIN_KEYS in CMD_PASSWD, da ključ ne bo mogel ustvariti novih ključev in ne bo mogel spremeniti Vašega gesla. Če ključ kljub temu uide v javnost, ga izbrišite in ustvarite novega, ne da bi morali spremeniti svoje geslo.

Kako ustvarite ključ, je po korakih opisano v priročniku DirectAdmin: Prijavni ključi: prijava za skripte in programe.

Dobro je vedeti

• Če se skripta večkrat poskuša prijaviti z napačnim geslom ali napačnim ključem, naš požarni zid blokira ta naslov IP. Če Vaša skripta nenadoma ne more več vzpostaviti povezave, si oglejte Ali je moj naslov IP blokiran?.
• Z veseljem pomagamo, če API sam ne deluje, vendar ne pišemo ali preverjamo lastnih skript. Za to uporabite spodnjo dokumentacijo DirectAdmin.
• Ali raje upravljate svoje gostovanje s Claude, ChatGPT ali Mistral, ne da bi sami programirali? Oglejte si naš MCP-strežnik za UI.

Dokumentacija DirectAdmin

Dokumentacija DirectAdmin je v angleščini:

• API Access: kako API deluje, prijava in različne vrste API-ja.
• Examples: primeri s curl, Bash, PHP in Python.
• Legacy API: starejši ukazi CMD_API in njihovi odgovori.
• Pregled ukazov CMD_API: iskanje po vseh starejših ukazih.
• Creating a login key: prijavni ključi po navodilih DirectAdmin.

Oglejte si tudi v priročniku DirectAdmin: Kako najdete ime strežnika in uporabniško ime DA.