Korištenje DirectAdmin API-ja: upravljanje Vašim paketom pomoću skripti

DirectAdmin ima API: način da upravljate svojim paketom pomoću skripte ili programa umjesto mišem. Gotovo sve što radite u panelu, može se obaviti i putem API-ja. Pomislite na ažuriranje DNS zapisa kada se promijeni Vaša kućna IP adresa, izradu mailboxova iz vlastitog softvera ili svaku noć dohvaćanje popisa Vaših baza podataka.

Mogu li koristiti API sa svojim paketom?

Da. API radi sa svakim paketom koji uključuje DirectAdmin: svim web hosting paketima, a i e-mail paketima. Reselleri uz to mogu njime upravljati računima svojih vlastitih klijenata. Ne morate ništa posebno zatražiti i to ne stoji ništa dodatno.

Skripta ima točno ista prava kao i Vi u DirectAdminu. Dakle, može djelovati samo unutar Vašeg vlastitog paketa i samo s onim stvarima koje Vaš paket dopušta.

Kako to funkcionira

• Adresa: s API-jem komunicirate na istom mjestu gdje se i prijavljujete: https://nazivservera:2222. Naziv servera možete pronaći u Moj WebOké kod paketa pod Upravljajte.
• Dvije vrste naredbi: novi API, s adresama koje počinju s /api/ i odgovorima u JSON formatu, te stariji API s naredbama poput /CMD_API_.... Počnite s novim API-jem. Ono što se tamo još ne nalazi, pronaći ćete u starom API-ju. Dodajte na kraj ?json=yes za odgovor u JSON formatu.
• Prijava: svaka naredba šalje Vaše DA korisničko ime i lozinku (HTTP Basic autentifikacija). Za to po mogućnosti koristite prijavni ključ (login key), a ne Vašu stvarnu DA lozinku, vidjeti dolje.
• Dokumentacija u Vašem vlastitom panelu: u DirectAdminu pod Support & Help pronaći ćete API Documentation. Tamo vidite sve naredbe novog API-ja i odmah ih možete isprobati s vlastitim računom.

Primjer

Ovom naredbom dohvaćate baze podataka svog paketa. Zamijenite korisnik, kljuc i nazivservera vlastitim podacima:

curl -u 'korisnik:kljuc' https://nazivservera:2222/api/db-show/databases

Dobit ćete popis u JSON formatu. Na isti način to funkcionira iz PHP-a, Pythona ili bilo kojeg drugog jezika koji može dohvatiti web adresu.

Siguran rad s prijavnim ključem

Nikada skripti ne dajte svoju obično DA lozinku. U DirectAdminu pod Prijavni ključevi izradite poseban ključ. Takav ključ možete ograničiti:

• samo na naredbe koje su skripti doista potrebne;
• samo s IP adrese računala ili servera na kojem skripta radi;
• s datumom isteka, ako Vam je pristup potreban samo kratko vrijeme.

U svakom slučaju isključite naredbe CMD_LOGIN_KEYS i CMD_PASSWD, kako ključ ne bi mogao izraditi nove ključeve niti promijeniti Vašu lozinku. Ako ključ ipak procuri, uklonite ga i izradite novi, bez potrebe da mijenjate svoju lozinku.

Kako izraditi ključ, korak po korak opisano je u DirectAdmin priručniku: Prijavni ključevi: prijava za skripte i programe.

Dobro je znati

• Ako skripta često pokušava prijavu s pogrešnom lozinkom ili pogrešnim ključem, naš firewall blokira tu IP adresu. Pogledajte Jesam li blokiran? ako Vaša skripta odjednom više ne može uspostaviti vezu.
• Rado pomažemo ako sam API ne radi, ali ne pišemo niti provjeravamo vlastite skripte. Za to koristite dokumentaciju DirectAdmina u nastavku.
• Želite li radije upravljati svojim hostingom putem Claude, ChatGPT ili Mistral, bez vlastitog programiranja? Pogledajte naš MCP server za AI.

Dokumentacija DirectAdmina

Dokumentacija DirectAdmina je na engleskom jeziku:

• API Access: kako funkcionira API, prijava i različite vrste API-ja.
• Examples: primjeri s curl, Bash, PHP i Python.
• Legacy API: starije CMD_API naredbe i njihovi odgovori.
• Pregled CMD_API naredbi: pretraživanje svih starijih naredbi.
• Creating a login key: prijavni ključevi prema DirectAdminu.

Pogledajte i u DirectAdmin priručniku: Pronalaženje naziva servera i DA korisničkog imena.