WordPress REST API: Τι είναι και πώς να ξεκινήσετε τη χρήση του

Εάν έχετε περάσει οποιαδήποτε στιγμή στην κοινότητα του WordPress τα τελευταία χρόνια, είναι πιθανό να έχετε ακούσει αναφορά στο νέο REST API. Ωστόσο, αν δεν είστε έμπειρος προγραμματιστής, ενδέχεται να μην έχετε ιδέα τι είναι πραγματικά το WordPress REST API.


Ενώ οι τεχνικές λεπτομέρειες είναι λίγο περίπλοκες, οι βασικές έννοιες πίσω από αυτό το χαρακτηριστικό είναι αρκετά εύκολο να κατανοηθούν. Το νέο API συμβάλλει στην επέκταση του τι μπορεί να κάνει το WordPress ως πλατφόρμα. Επιπλέον, το REST API το καθιστά απλούστερο από ποτέ για τους προγραμματιστές να συνδέουν το WordPress με άλλους ιστότοπους και εφαρμογές.

API REST WordPress

Σε αυτόν τον ολοκληρωμένο οδηγό, θα σας καθοδηγήσουμε σε όλα τα βασικά στοιχεία που πρέπει να γνωρίζετε. Θα εξηγήσουμε ποια είναι τα API γενικά και ποια είναι τα REST API (και η έκδοση ειδικά για το WordPress). Στη συνέχεια, θα μιλήσουμε για το πώς να αρχίσετε να χρησιμοποιείτε το WordPress REST API μόνοι σας. Ας πηδήξουμε ακριβώς μέσα!

Εισαγωγή στις διεπαφές προγραμματισμού εφαρμογών (API)

Προτού ερευνήσουμε συγκεκριμένα το REST API, ας δημιουργήσουμε αντίγραφα ασφαλείας λίγο. Για να κατανοήσουμε αυτήν την ιδέα, είναι βασικό να έχουμε πρώτα μια βασική ιδέα για το τι είναι τα API γενικά.

Στο πιο θεμελιώδες επίπεδο, ένα API – ή διεπαφή προγραμματισμού εφαρμογών – επιτρέπει σε δύο εφαρμογές να επικοινωνούν μεταξύ τους. Για παράδειγμα, όταν επισκέπτεστε έναν ιστότοπο, το πρόγραμμα περιήγησής σας στέλνει ένα αίτημα στον διακομιστή όπου βρίσκεται αυτός ο ιστότοπος. Το API αυτού του διακομιστή είναι αυτό που λαμβάνει το αίτημα του προγράμματος περιήγησής σας, το ερμηνεύει και στέλνει πίσω όλα τα δεδομένα που απαιτούνται για την προβολή του ιστότοπού σας.

Υπάρχουν πολλά περισσότερα τον τρόπο λειτουργίας των API φυσικά, με τεχνική έννοια. Ωστόσο, θα επικεντρωθούμε σε αυτό που πιθανότατα έχει μεγαλύτερη σημασία για εσάς – τις πρακτικές εφαρμογές. Τα API προσελκύουν μεγάλη προσοχή και ορατότητα, επειδή πολλές εταιρείες έχουν αρχίσει να τα συσκευάζουν και να τα παρέχουν ως προϊόντα που μπορείτε να χρησιμοποιήσετε.

Με άλλα λόγια, οι προγραμματιστές σε μια εταιρεία όπως η Google θα συλλέξουν μερικά μέρη του κώδικα της εφαρμογής τους και κάντε το διαθέσιμο στο κοινό. Με αυτόν τον τρόπο, άλλοι προγραμματιστές μπορούν να χρησιμοποιήσουν το API ως εργαλείο για να βοηθήσουν τους δικούς τους ιστότοπους να συνδεθούν στο Google και να επωφεληθούν από τις δυνατότητές του:

Βιβλιοθήκη API της Google.

Για παράδειγμα, θα μπορούσατε να χρησιμοποιήσετε το API Χαρτών Google για να τοποθετήστε έναν πλήρως λειτουργικό χάρτη στον ιστότοπό σας που επωφελείται από όλα τα σχετικά δεδομένα και λειτουργίες της Google. Αυτό σας εξοικονομεί από το να χρειάζεται να κωδικοποιήσετε έναν χάρτη και να συλλέξετε μόνοι σας όλα αυτά τα δεδομένα. Το ίδιο ισχύει για ένα ευρύ φάσμα ιστότοπων και εφαρμογών.

Καθώς οι ιστότοποι και η λειτουργικότητα στην οποία βασίζονται γίνονται πιο περίπλοκα, εργαλεία όπως τα API καθίστανται ζωτικής σημασίας. Δίνουν τη δυνατότητα στους προγραμματιστές να αξιοποιήσουν την υπάρχουσα λειτουργικότητα, επιτρέποντας απλώς «σύνδεση» νέων λειτουργιών στον ιστότοπό σας. Με τη σειρά του, ο ιστότοπος που κατέχει το API επωφελείται από την αυξημένη έκθεση και την επισκεψιμότητα.

Οι θεμελιώδεις κανόνες ενός REST (αντιπροσωπευτική μεταφορά κράτους) API

Υπάρχουν πολλοί τρόποι δημιουργίας ενός API. ΕΝΑ REST (αντιπροσωπευτική μεταφορά κατάστασης) API είναι ένας συγκεκριμένος τύπος που αναπτύσσεται σύμφωνα με συγκεκριμένους κανόνες. Με άλλα λόγια, το REST παρουσιάζει ένα σύνολο οδηγιών που μπορούν να χρησιμοποιήσουν οι προγραμματιστές κατά τη δημιουργία API. Αυτό διασφαλίζει ότι τα API λειτουργούν αποτελεσματικά.

Για να κατανοήσετε πώς λειτουργούν τα API REST, πρέπει επομένως να γνωρίζετε ποιοι κανόνες (ή «περιορισμοί») λειτουργούν. Υπάρχουν πέντε βασικά στοιχεία που κάνουν ένα API «RESTful». Λάβετε υπόψη ότι ο «διακομιστής» είναι η πλατφόρμα στην οποία ανήκει το API και ο «πελάτης» είναι ο ιστότοπος, η εφαρμογή ή το λογισμικό που συνδέεται με αυτήν την πλατφόρμα:

Ξεκουραστικός

  1. Αρχιτεκτονική διακομιστή-πελάτη. Το API πρέπει να δημιουργηθεί έτσι ώστε ο πελάτης και ο διακομιστής να παραμένουν ξεχωριστά μεταξύ τους. Με αυτόν τον τρόπο μπορούν να συνεχίσουν να αναπτύσσονται μόνοι τους και μπορούν να χρησιμοποιηθούν ανεξάρτητα.
  2. Ανιθαγένεια. Τα API REST πρέπει να ακολουθούν ένα πρωτόκολλο «απάτριδες». Με άλλα λόγια, δεν μπορούν να αποθηκεύσουν πληροφορίες σχετικά με τον πελάτη στον διακομιστή. Το αίτημα του πελάτη πρέπει να περιλαμβάνει όλα τα απαραίτητα δεδομένα εκ των προτέρων και η απάντηση θα πρέπει να παρέχει όλα όσα χρειάζεται ο πελάτης. Αυτό καθιστά κάθε αλληλεπίδραση μια συμφωνία «one and done» και μειώνει τόσο τις απαιτήσεις μνήμης όσο και τις πιθανότητες σφαλμάτων.
  3. Δυνατότητα αποθήκευσης. Μια «προσωρινή μνήμη» είναι η προσωρινή αποθήκευση συγκεκριμένων δεδομένων, οπότε μπορεί να ανακτηθεί και να σταλεί γρηγορότερα. Τα RESTful API χρησιμοποιούν δεδομένα με δυνατότητα προσωρινής αποθήκευσης όποτε είναι δυνατόν, για να βελτιώσουν την ταχύτητα και την αποτελεσματικότητα. Επιπλέον, το API πρέπει να ενημερώσει τον πελάτη εάν κάθε κομμάτι δεδομένων μπορεί και πρέπει να αποθηκευτεί στην κρυφή μνήμη.
  4. Πολυεπίπεδη σύστημα. Τα καλά σχεδιασμένα API REST κατασκευάζονται χρησιμοποιώντας στρώματα, το καθένα με τη δική του καθορισμένη λειτουργικότητα. Αυτά τα επίπεδα αλληλεπιδρούν, αλλά παραμένουν ξεχωριστά. Αυτό καθιστά το API ευκολότερο να τροποποιηθεί και να ενημερωθεί με την πάροδο του χρόνου, και επίσης βελτιώνει την ασφάλειά του.
  5. Ομοιόμορφη διεπαφή. Όλα τα μέρη ενός REST API πρέπει να λειτουργούν μέσω της ίδιας διεπαφής και να επικοινωνούν χρησιμοποιώντας τις ίδιες γλώσσες. Αυτή η διεπαφή πρέπει να σχεδιαστεί ειδικά για το API και να μπορεί να εξελιχθεί από μόνη της. Δεν πρέπει να εξαρτάται από το διακομιστή ή τον πελάτη για να λειτουργήσει.

Οποιοδήποτε API που ακολουθεί αυτές τις αρχές μπορεί να θεωρηθεί RESTful. Υπάρχει επίσης ένας έκτος περιορισμός, που αναφέρεται ως «κώδικας κατ ‘απαίτηση». Όταν ακολουθείται, αυτή η τεχνική επιτρέπει στο API να δώσει εντολή στον διακομιστή να μεταδώσει κώδικα σε έναν πελάτη, προκειμένου να επεκτείνει τη λειτουργικότητά του. Ωστόσο, αυτός ο περιορισμός είναι προαιρετικός και δεν υιοθετείται από όλα τα API REST.

Το API REST του WordPress

Σε αυτό το σημείο, ίσως αναρωτιέστε πώς όλα αυτά σας επηρεάζουν. Τα API είναι εξαιρετικά εργαλεία, αλλά είναι σχετικά με την καθημερινή εργασία σας; Εάν είστε χρήστης του WordPress, η απάντηση είναι ξεκάθαρα "Ναί".

Το WordPress REST API βρίσκεται υπό ανάπτυξη εδώ και μερικά χρόνια. Για αρκετό καιρό, επεξεργάστηκε ως ένα ανεξάρτητο πρόσθετο, με το οποίο οι προγραμματιστές θα μπορούσαν να συνεισφέρουν με την πάροδο του χρόνου ήταν διαθέσιμο για οποιονδήποτε πειραματιστεί.

Στην πραγματικότητα, υπήρχαν δύο ξεχωριστές εκδόσεις της προσθήκης REST API. Στοιχεία του API προστέθηκαν στην κεντρική πλατφόρμα ήδη από την ενημέρωση 4.4. Αυτό ακολουθήθηκε από την πλήρη ενσωμάτωσή του από το WordPress 4.7 (το 2016). Αυτό σημαίνει ότι σήμερα, το WordPress διαθέτει το δικό του πλήρως λειτουργικό REST API.

Γιατί η πλατφόρμα έκανε αυτήν την κίνηση; Σύμφωνα με τον ιστότοπο του έργου από μόνο του, είναι επειδή το WordPress κινείται προς το να γίνει ένα "πλήρες πλαίσιο εφαρμογής". Με άλλα λόγια, το REST API επιτρέπει στην πλατφόρμα να αλληλεπιδρά με σχεδόν οποιονδήποτε ιστότοπο και εφαρμογή ιστού. Επιπλέον, μπορεί να επικοινωνεί και να ανταλλάσσει δεδομένα ανεξάρτητα από τις γλώσσες που χρησιμοποιεί ένα εξωτερικό πρόγραμμα.

υπόλοιπο api

Αυτό ανοίγει πολλές δυνατότητες για προγραμματιστές. Κάνει επίσης το WordPress ως πλατφόρμα πιο ευέλικτο και καθολικό από ποτέ. Ως Katie Keith, Διευθυντής Επιχειρήσεων στο Barn2 Media το βάζει:

Με την κατανόηση του REST API, οι προγραμματιστές του WordPress μπορούν να επιλέξουν τον πιο αποτελεσματικό τρόπο υλοποίησης κάθε εργασίας, χωρίς να περιορίζονται σε συγκεκριμένες τεχνολογίες ή πλατφόρμες όπως η PHP ή το WordPress back-end. Χρησιμοποιείται αποτελεσματικά, το REST API κάνει πολύ πιο εύκολη την ενσωμάτωση τρίτων… Ανοίγει ακόμη και νέες ευκαιρίες, για παράδειγμα να δημιουργήσετε τις δικές σας εφαρμογές για κινητές συσκευές που βασίζονται στο WordPress ή να εξερευνήσετε νέους και μοναδικούς τρόπους επικοινωνίας με το WordPress.

Είναι επίσης σημαντικό να σημειωθεί ότι μπορεί να ακούτε αυτήν τη λειτουργία που μερικές φορές αναφέρεται ως το WordPress JSON REST API. Το μέρος «JSON», που σημαίνει το Object Object Notation, περιγράφει τη μορφή που χρησιμοποιεί αυτό το API για την ανταλλαγή δεδομένων. Αυτή η μορφή βασίζεται σε JavaScript και είναι ένας δημοφιλής τρόπος ανάπτυξης API χάρη στο πόσο καλά διασυνδέεται με πολλές κοινές γλώσσες προγραμματισμού. Με άλλα λόγια, ένα JSON API μπορεί να διευκολύνει ευκολότερα την επικοινωνία μεταξύ εφαρμογών που χρησιμοποιούν διαφορετικές γλώσσες.

Η ανατομία ενός αιτήματος API REST του WordPress

Τώρα πρέπει να κατανοήσετε τον γενικό σκοπό και την κατεύθυνση του WordPress REST API. Ως εκ τούτου, ας δούμε μερικές λεπτομέρειες για το πώς λειτουργεί. Υπάρχουν ορισμένες βασικές έννοιες που θα πρέπει να καταλάβετε εάν θέλετε να αποκτήσετε πρακτική εφαρμογή και να αρχίσετε να πειραματίζεστε μόνοι σας με το API.

Όπως εξηγήσαμε, κάθε API επεξεργάζεται αιτήματα και επιστρέφει απαντήσεις. Με άλλα λόγια, ένας πελάτης του ζητά να εκτελέσει μια συγκεκριμένη ενέργεια και το API πραγματοποιεί αυτήν την ενέργεια. Ο ακριβής τρόπος με τον οποίο τα API το κάνουν αυτό μπορεί να διαφέρει. Τα API REST έχουν σχεδιαστεί ειδικά για να λαμβάνουν και να ανταποκρίνονται σε συγκεκριμένο τύπο αιτημάτων, χρησιμοποιώντας απλές εντολές HTML (ή «μεθόδους»).

Για παράδειγμα, εδώ είναι τα περισσότερα βασικές και σημαντικές μεθόδους HTML ένας πελάτης μπορεί να στείλει:

Μέθοδοι HTML

  • ΠΑΙΡΝΩ: Αυτή η εντολή ανακτά έναν πόρο από το διακομιστή (όπως ένα συγκεκριμένο κομμάτι δεδομένων).
  • ΘΕΣΗ: Με αυτό, ο πελάτης προσθέτει έναν πόρο στο διακομιστή.
  • ΒΑΖΩ: Μπορείτε να το χρησιμοποιήσετε για να επεξεργαστείτε ή να ενημερώσετε έναν πόρο που υπάρχει ήδη στο διακομιστή.
  • ΔΙΑΓΡΑΦΩ: Όπως υποδηλώνει το όνομα, αυτό αφαιρεί έναν πόρο από το διακομιστή.

Μαζί με αυτές τις εντολές, ο πελάτης θα στείλει μία ή περισσότερες γραμμές που επικοινωνούν ακριβώς ποιος πόρος είναι επιθυμητός και τι πρέπει να γίνει με αυτόν. Για παράδειγμα, ένα αίτημα για μεταφόρτωση ενός αρχείου PHP σε έναν συγκεκριμένο φάκελο σε έναν διακομιστή μπορεί να μοιάζει με αυτό:

POST /foldername/my_file.php

Το τμήμα /foldername/my_file.php είναι ονομάζεται «διαδρομή», αφού λέει στο API πού να πάει και με ποια δεδομένα να αλληλεπιδράσει. Όταν το συνδυάζετε με τη μέθοδο HTTP (POST σε αυτήν την περίπτωση), ολόκληρη η λειτουργία αναφέρεται ως «τελικό σημείο».

Τα περισσότερα API REST και οι πελάτες που αλληλεπιδρούν μαζί τους γίνονται πολύ πιο περίπλοκα από αυτό – περιλαμβάνεται η έκδοση του WordPress. Ωστόσο, αυτά τα βασικά στοιχεία αποτελούν τη βάση για το πώς λειτουργεί το WordPress REST API.

Πώς να ξεκινήσετε να χρησιμοποιείτε το WordPress REST API

Εφόσον έχετε ρυθμίσει έναν ιστότοπο WordPress, μπορείτε να ξεκινήσετε να πειραματίζεστε αμέσως με το REST API. Μπορείτε να εκτελέσετε διάφορα αιτήματα GET για να ανακτήσετε δεδομένα απευθείας, απλά χρησιμοποιώντας το πρόγραμμα περιήγησής σας.

Για να αποκτήσετε πρόσβαση στο WordPress REST API, θα πρέπει να ξεκινήσετε με την ακόλουθη διαδρομή:

yoursite.com/wp-json/wp/v2

Στη συνέχεια, μπορείτε να προσθέσετε σε αυτήν τη διεύθυνση URL για πρόσβαση σε διάφορους τύπους δεδομένων. Για παράδειγμα, θα μπορούσατε να αναζητήσετε ένα συγκεκριμένο προφίλ χρήστη μέσω μιας διαδρομής όπως αυτή:

yoursite.com/wp-json/wp/v2/users/4567

Σε αυτό το σενάριο, "4567" είναι το μοναδικό αναγνωριστικό χρήστη για το προφίλ που θέλετε να δείτε. Εάν παραλείψατε αυτό το αναγνωριστικό, θα δείτε αντ ‘αυτού μια λίστα με όλους τους χρήστες στον ιστότοπό σας:

Μια λίστα χρηστών στο WordPress REST API.

Μπορείτε να χρησιμοποιήσετε την ίδια βασική διαδρομή για να δείτε άλλους τύπους δεδομένων, όπως τις αναρτήσεις ή τις σελίδες σας. Μπορείτε ακόμη και να αναζητήσετε υποσύνολα των δεδομένων που πληρούν συγκεκριμένα κριτήρια. Για παράδειγμα, μπορείτε να ανακτήσετε όλες τις αναρτήσεις που περιλαμβάνουν έναν συγκεκριμένο όρο χρησιμοποιώντας αυτήν τη διεύθυνση URL:

yoursite.com/wp-json/wp/v2/posts?=search[keyword]

Φυσικά, αυτή είναι μια απλή απεικόνιση. Δεν υπάρχει σχεδόν κανένα όριο σε αυτό που μπορείτε πραγματικά να κάνετε χρησιμοποιώντας το WordPress REST API. Εάν θέλετε να μάθετε περισσότερα σχετικά με τον τρόπο λειτουργίας του, σας συνιστούμε να ξεκινήσετε με τους ακόλουθους πόρους:

Το WordPress REST API είναι αναμφίβολα ένα πολύπλοκο θέμα. Ακόμη και για μη προγραμματιστές, ωστόσο, αξίζει να κατανοήσετε τα βασικά στοιχεία για το πώς λειτουργεί αυτή η τεχνολογία και τι καθιστά δυνατό. Επιπλέον, μπορεί ακόμη και να σας επιτρέψει να αρχίσετε να ασχολείστε με τον εαυτό σας!

Μία ακόμη προσέγγιση στη χρήση του API REST του WordPress

Το WordPress REST API μπορεί να χρησιμοποιηθεί για πολλά ενδιαφέροντα πράγματα και έργα. Το αποδείξαμε αρκετά ξεκάθαρα.

Υπάρχει, ωστόσο, ένας τομέας στον οποίο αποκτά πραγματική δημοτικότητα:

Ακέφαλο WordPress είναι η ιδέα της αποσύνδεσης των δύο κύριων επιπέδων του οικοσυστήματος WordPress – το backend και το frontend.

Αυτό σας επιτρέπει να πάρετε όλα τα καλούδια που διαθέτει το λογισμικό WordPress και να τα συνδέσετε με ένα τελικό προϊόν που δεν χρησιμοποιεί την τυπική παρουσίαση του WordPress – δεν είναι από μόνο του ένας ιστότοπος.

Η όλη ιδέα είναι πολύ ενδιαφέρουσα. Μιλάμε για αυτό ακόμα περισσότερο σε μια άλλη ανάρτηση, όπου συζητάμε για το αν το headless WordPress έχει νόημα και συγκρίνουμε τις κορυφαίες λύσεις φιλοξενίας WordPress χωρίς κεφαλή στην αγορά.

συμπέρασμα

Δεν υπάρχει καλύτερος χρόνος για να μάθετε για το WordPress REST API από τώρα. Δεδομένου ότι έχει ενσωματωθεί πλήρως στον πυρήνα του WordPress, πρόκειται να διαδραματίσει σημαντικό ρόλο στο μέλλον της πλατφόρμας. Οι προγραμματιστές όλων των λωρίδων θα χρησιμοποιούν αυτό το API για να συνδέσουν το WordPress με τον ευρύτερο ιστό με τρόπους που ήταν προηγουμένως δύσκολες ή αδύνατες.

Η κατανόηση αυτής της ιδέας για τον εαυτό σας μπορεί να είναι λίγο δύσκολη. Σε βασικό επίπεδο, ωστόσο, οι έννοιες είναι αρκετά εύκολες. Το REST API είναι μια διεπαφή που επιτρέπει σε δύο προγράμματα να «μιλούν» μεταξύ τους και δημιουργείται ακολουθούν οδηγίες που διασφαλίζουν ότι είναι ευέλικτο, επεκτάσιμο και ασφαλές. Εάν θέλετε να ερευνήσετε βαθύτερα πώς λειτουργεί όλα αυτά και πώς μπορεί να χρησιμοποιηθεί, υπάρχουν πολλοί χρήσιμοι πόροι εκεί έξω, όπως ο επίσημος εγχειρίδιο.

Έχετε απορίες σχετικά με το REST API και τι σημαίνει για το WordPress; Ρωτήστε μας στην παρακάτω ενότητα σχολίων!

Μην ξεχάσετε να συμμετάσχετε στο μάθημα συντριβής για την επιτάχυνση του ιστότοπού σας στο WordPress. Με μερικές απλές επιδιορθώσεις, μπορείτε να μειώσετε το χρόνο φόρτωσής σας ακόμη και κατά 50-80%:

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map