Χρήση του DirectAdmin API: διαχείριση του πακέτου σας με scripts
Το DirectAdmin διαθέτει API: έναν τρόπο διαχείρισης του πακέτου σας μέσω ενός script ή προγράμματος αντί με το ποντίκι. Σχεδόν όλα όσα κάνετε στον πίνακα ελέγχου μπορούν να γίνουν και μέσω του API. Σκεφτείτε την ενημέρωση μιας εγγραφής DNS όταν αλλάζει η διεύθυνση IP στο σπίτι σας, τη δημιουργία mailboxes από το δικό σας λογισμικό ή την ανάκτηση κάθε βράδυ μιας λίστας με τις βάσεις δεδομένων σας.
Μπορώ να χρησιμοποιήσω το API με το πακέτο μου;
Ναι. Το API λειτουργεί με κάθε πακέτο που περιλαμβάνει DirectAdmin: όλα τα πακέτα web hosting καθώς και τα πακέτα email. Οι μεταπωλητές (resellers) μπορούν επιπλέον να το χρησιμοποιήσουν για τη διαχείριση των λογαριασμών των δικών τους πελατών. Δεν χρειάζεται να αιτηθείτε τίποτα και δεν κοστίζει επιπλέον.
Ένα script έχει ακριβώς τα ίδια δικαιώματα με εσάς στο DirectAdmin. Μπορεί επομένως να λειτουργήσει μόνο στο δικό σας πακέτο, και μόνο για όσα επιτρέπει το πακέτο σας.
Πώς λειτουργεί
- Διεύθυνση: επικοινωνείτε με το API στο ίδιο σημείο όπου συνδέεστε: https://διακομιστη:2222. Το όνομα του διακομιστή σας το βρίσκετε στο Το WebOké μου, στο πακέτο, κάτω από το Διαχείριση.
- Δύο είδη εντολών: το νέο API, με διευθύνσεις που ξεκινούν με /api/ και απαντήσεις σε μορφή JSON, και το παλαιότερο API με εντολές όπως /CMD_API_.... Ξεκινήστε από το νέο API. Ό,τι δεν υπάρχει ακόμη εκεί, θα το βρείτε στο παλαιό API. Προσθέστε εκεί ?json=yes για απάντηση σε μορφή JSON.
- Σύνδεση: κάθε εντολή στέλνει το όνομα χρήστη DA και έναν κωδικό πρόσβασης (HTTP Basic authentication). Για αυτό χρησιμοποιήστε κατά προτίμηση ένα κλειδί σύνδεσης (login key) και όχι τον πραγματικό σας κωδικό πρόσβασης DA, δείτε παρακάτω.
- Τεκμηρίωση στον δικό σας πίνακα: στο DirectAdmin θα βρείτε κάτω από το Support & Help το API Documentation. Εκεί βλέπετε όλες τις εντολές του νέου API και μπορείτε να τις δοκιμάσετε αμέσως με τον δικό σας λογαριασμό.
Ένα παράδειγμα
Με αυτήν την εντολή ζητάτε τις βάσεις δεδομένων του πακέτου σας. Αντικαταστήστε τα χρήστη, κλειδί και διακομιστή με τα δικά σας στοιχεία:
curl -u 'χρηστη:κλειδι' https://διακομιστη:2222/api/db-show/databases
Θα λάβετε μια λίστα σε μορφή JSON. Με τον ίδιο τρόπο λειτουργεί από PHP, Python ή οποιαδήποτε άλλη γλώσσα που μπορεί να ζητήσει μια διεύθυνση ιστού.
Ασφαλής εργασία με ένα κλειδί σύνδεσης
Μην δίνετε ποτέ σε ένα script τον κανονικό σας κωδικό πρόσβασης DA. Δημιουργήστε στο DirectAdmin, στο Κλειδιά Σύνδεσης, ένα ξεχωριστό κλειδί. Ένα τέτοιο κλειδί μπορείτε να το περιορίσετε:
- μόνο στις εντολές που πραγματικά χρειάζεται το script,
- μόνο από τη διεύθυνση IP του υπολογιστή ή του διακομιστή όπου εκτελείται το script,
- με ημερομηνία λήξης, αν χρειάζεστε την πρόσβαση μόνο για λίγο.
Αποκλείστε σε κάθε περίπτωση τις εντολές CMD_LOGIN_KEYS και CMD_PASSWD, ώστε το κλειδί να μην μπορεί να δημιουργήσει νέα κλειδιά ούτε να αλλάξει τον κωδικό πρόσβασής σας. Αν παρόλα αυτά διαρρεύσει το κλειδί, διαγράψτε το και δημιουργήστε ένα νέο, χωρίς να χρειάζεται να αλλάξετε τον κωδικό πρόσβασής σας.
Πώς δημιουργείτε ένα κλειδί περιγράφεται βήμα προς βήμα στον οδηγό του DirectAdmin: Κλειδιά Σύνδεσης: σύνδεση για scripts και προγράμματα.
Καλό να γνωρίζετε
- Αν ένα script προσπαθεί επανειλημμένα να συνδεθεί με λανθασμένο κωδικό πρόσβασης ή λανθασμένο κλειδί, το firewall μας αποκλείει αυτή τη διεύθυνση IP. Επισκεφθείτε τη σελίδα Έχω αποκλειστεί; αν το script σας σταματήσει ξαφνικά να συνδέεται.
- Ευχαρίστως σας βοηθάμε αν το ίδιο το API δεν λειτουργεί, όμως δεν γράφουμε ούτε ελέγχουμε δικά σας scripts. Χρησιμοποιήστε γι' αυτό την παρακάτω τεκμηρίωση του DirectAdmin.
- Προτιμάτε να διαχειρίζεστε το hosting σας με το Claude, το ChatGPT ή το Mistral, χωρίς να προγραμματίζετε εσείς οι ίδιοι; Τότε ρίξτε μια ματιά στον δικό μας MCP server για AI.
Τεκμηρίωση του DirectAdmin
Η τεκμηρίωση του DirectAdmin είναι στα αγγλικά:
- API Access: πώς λειτουργεί το API, η σύνδεση και τα διάφορα είδη API.
- Examples: παραδείγματα με curl, Bash, PHP και Python.
- Legacy API: οι παλαιότερες εντολές CMD_API και οι απαντήσεις τους.
- Επισκόπηση εντολών CMD_API: αναζήτηση σε όλες τις παλαιότερες εντολές.
- Creating a login key: κλειδιά σύνδεσης σύμφωνα με το DirectAdmin.
Δείτε επίσης στον οδηγό του DirectAdmin: Εύρεση του ονόματος διακομιστή και του ονόματος χρήστη DA.