Utilizarea API-ului DirectAdmin: gestionarea pachetului dumneavoastră cu scripturi

DirectAdmin dispune de un API: o modalitate de a vă administra pachetul cu ajutorul unui script sau program, în loc de a folosi mausul. Aproape tot ce faceți în panou poate fi realizat și prin API. Gândiți-vă la actualizarea unei înregistrări DNS atunci când adresa dvs. IP de acasă se schimbă, la crearea de căsuțe de e-mail din propriul software sau la solicitarea în fiecare noapte a unei liste cu bazele dvs. de date.

Puteți folosi API-ul cu pachetul dumneavoastră?

Da. API-ul funcționează cu orice pachet care include DirectAdmin: toate pachetele de găzduire web, precum și pachetele de e-mail. În plus, resellerii pot administra cu ajutorul acestuia conturile propriilor clienți. Nu trebuie să solicitați nimic și nu costă suplimentar.

Un script are exact aceleași drepturi ca dumneavoastră în DirectAdmin. Prin urmare, acesta poate acționa doar asupra propriului dvs. pachet și doar pentru acele lucruri pe care pachetul dvs. le permite.

Cum funcționează

• Adresă: comunicați cu API-ul în același loc în care vă conectați: https://numeserver:2222. Numele serverului dumneavoastră îl găsiți în Contul meu WebOké, la pachet, sub Administrare.
• Două tipuri de comenzi: noul API, cu adrese care încep cu /api/ și răspunsuri în format JSON, și API-ul mai vechi, cu comenzi precum /CMD_API_.... Începeți cu noul API. Ceea ce încă nu se regăsește acolo găsiți în API-ul vechi. Adăugați ?json=yes la final pentru a obține un răspuns în format JSON.
• Autentificare: fiecare comandă trimite numele dvs. de utilizator DA și o parolă (autentificare HTTP Basic). Pentru aceasta, utilizați de preferință o cheie de autentificare (login key) și nu parola dvs. reală DA, vezi mai jos.
• Documentație în panoul dumneavoastră: în DirectAdmin găsiți la Support & Help secțiunea API Documentation. Acolo vedeți toate comenzile noului API și le puteți testa imediat cu propriul cont.

Un exemplu

Cu această comandă solicitați bazele de date ale pachetului dumneavoastră. Înlocuiți utilizator, cheie și numeserver cu datele dumneavoastră:

curl -u 'utilizator:cheie' https://numeserver:2222/api/db-show/databases

Veți primi o listă în format JSON. În același mod funcționează și din PHP, Python sau orice alt limbaj care poate solicita o adresă web.

Lucrul în siguranță cu o cheie de autentificare

Nu oferiți niciodată unui script parola dvs. obișnuită DA. Creați în DirectAdmin, la Login Keys, o cheie separată. O astfel de cheie poate fi restricționată:

• doar la comenzile de care scriptul are cu adevărat nevoie;
• doar de la adresa IP a computerului sau serverului pe care rulează scriptul;
• cu o dată de expirare, dacă aveți nevoie de acces doar pentru scurt timp.

Excludeți în orice caz comenzile CMD_LOGIN_KEYS și CMD_PASSWD, astfel încât cheia să nu poată crea chei noi și să nu vă poată modifica parola. Dacă totuși cheia ajunge să fie compromisă, ștergeți-o și creați una nouă, fără a fi nevoie să vă schimbați parola.

Modul în care creați o cheie este descris pas cu pas în manualul DirectAdmin: Login Keys: autentificare pentru scripturi și programe.

Bine de știut

• Dacă un script încearcă de mai multe ori să se conecteze cu o parolă sau o cheie greșită, firewall-ul nostru blochează acea adresă IP. Consultați pagina Sunt blocat? dacă scriptul dumneavoastră nu mai reușește brusc să se conecteze.
• Vă ajutăm cu plăcere dacă API-ul în sine nu funcționează, dar nu scriem și nu verificăm scripturi proprii. Pentru aceasta, folosiți documentația DirectAdmin de mai jos.
• Preferați să vă administrați găzduirea cu Claude, ChatGPT sau Mistral, fără să programați dumneavoastră înșivă? Consultați atunci serverul nostru MCP pentru AI.

Documentația DirectAdmin

Documentația DirectAdmin este în limba engleză:

• API Access: cum funcționează API-ul, autentificarea și diferitele tipuri de API.
• Examples: exemple cu curl, Bash, PHP și Python.
• Legacy API: comenzile CMD_API mai vechi și răspunsurile acestora.
• Prezentare generală a comenzilor CMD_API: căutare în toate comenzile mai vechi.
• Creating a login key: chei de autentificare conform DirectAdmin.

Consultați, de asemenea, în manualul DirectAdmin: Găsirea numelui serverului și a numelui de utilizator DA.