Un'introduzione all'API REST di WordPress

Pubblicato: 2017-01-13

Il rilascio di WordPress 4.7 ha generato molta eccitazione nella comunità, e con buone ragioni. Oltre ai numerosi miglioramenti e funzionalità introdotti, il vero furto dello spettacolo è stato l'annuncio dell'integrazione del core dell'API REST. Come accennato nei post precedenti, questo trasforma efficacemente WordPress da una piattaforma di blogging a un Content Management System (CMS). Ma come avverrà questa trasformazione? E quali saranno i vantaggi per gli utenti?

In questo articolo, ti presenteremo prima alcuni concetti fondamentali e poi ti mostreremo come puoi iniziare a giocare con l'API e il tuo sito web.

Tutti i siti Web dei nostri clienti sono già stati aggiornati a WordPress 4.7.1. Allora cominciamo!

Che cos'è un'API?

API sta per Application Programming Interface . È un insieme di strutture documentate conformi a uno standard funzionante come blocchi LEGO per gli sviluppatori di software. Queste strutture possono essere strutture dati, chiamate di funzione, componenti di livello superiore, praticamente qualsiasi cosa. Gli sviluppatori di software utilizzano le API per creare software più complessi da esse. Sono spesso utilizzati come metodo di comunicazione tra vari componenti software, indipendentemente dal fatto che siano ospitati localmente (si pensi a librerie software) o in remoto su Internet, come nel caso delle API REST.

Esistono API per molti diversi livelli di software, dal sistema operativo al web.

Che cos'è un'API REST?

REST sta per REpresentational State Transfer e consente la stessa interoperabilità e comunicazione dei componenti, ma a un livello superiore: il Web. Con REST, puoi avere diversi software basati sul Web scritti in Python, Java o PHP, che comunicano e scambiano dati tra loro, anche se sono ospitati in sistemi diversi. Poiché ogni sistema sa come "parlare" REST, può parlare con chiunque lo faccia!

REST utilizza il protocollo HTTP come trasporto di comunicazione e le richieste HTTP standard per implementare le sue operazioni di base. Queste operazioni sono chiamate verbi. Quelli più comunemente usati sono: PUT, GET, PATCH, DELETE. Questi verbi agiscono sulle cose che REST chiama Resources. Sono implementati dallo sviluppatore del software e implementano efficacemente tutte e quattro le operazioni fondamentali del computer che funzionano sull'archiviazione: Crea, Leggi, Aggiorna, Elimina ( CRUD ).

Per la rappresentazione e lo scambio dei dati, REST utilizza una specifica di dati leggera denominata JSON ( Javascript Object Notation ). La struttura di JSON è molto semplice. La sua semplicità e facilità d'uso, rispetto alle specifiche di migliaia di pagine di XML et al, gli hanno fatto guadagnare l'adozione immediata da parte degli sviluppatori, rendendolo di fatto lo standard di interscambio di dati del Web.

Come lo implementa WordPress?

Quindi abbiamo il concetto di verbi (Create, Read, Update, Delete) che agiscono sulle Risorse. WordPress definisce come risorsa REST praticamente ogni elemento di informazione discreto esistente sulla piattaforma. Dagli utenti di un sito a impostazioni, post, tassonomie di post, notifiche, media, statistiche e tutto il resto. Ciò include le operazioni che possono essere definite per queste Risorse. Ad esempio, le operazioni definite per i commenti sono le seguenti:

Ottieni un elenco di commenti recenti.
Ottieni un elenco di commenti recenti su un post.
Ottieni un singolo commento.
Modifica un commento.
Crea un commento su un post.
Crea un commento come risposta a un altro commento.
Elimina un commento.
Ottieni i Mi piace per un commento.
Come un commento.
Rimuovi il tuo Mi piace da un commento.
Ottieni il tuo stato Mi piace per un commento.

Dai un'occhiata alla pagina di documentazione ufficiale dell'API per WordPress a tuo agio, per avere un'idea dell'ampiezza e della profondità dell'API e verificare cosa può fare. Le possibilità sono tante!

WordPress, quindi, diventa una piattaforma di sviluppo e un CMS trattando ogni bit di dati che esiste su di esso come una Risorsa REST . Li espone tutti sotto un'API pubblica e standardizzata che consente a parti esterne di eseguire operazioni CRUD su di essi . In questo modo WordPress si apre e diventa interoperabile con il resto del mondo del software, sia esso Java, Python o Ruby; e praticamente con ogni lingua o sistema che sa comunicare usando REST.

Provalo tu stesso

Esistono diversi modi per iniziare ad armeggiare con l'API REST del tuo sito web. Il più semplice da utilizzare un plug-in di test REST sul tuo browser. Ce ne sono diversi in giro, ma il più popolare è Postman (disponibile per MacOSX, Windows e Chrome).

Supponiamo ad esempio di voler recuperare un oggetto JSON contenente tutti i post del nostro blog. Per fare ciò, devi prima consultare il riferimento REST ufficiale di WordPress, in modo da scoprire la Base Route di quella chiamata di richiesta (è /wp/v2/posts ).

Tutto ciò che dobbiamo fare ora è quanto segue:

Seleziona OTTIENI dal menu a discesa. Ci sono molti verbi REST disponibili come puoi vedere, ma coprirli tutti non è lo scopo di questo articolo.
Aggiungi la Base Route ( /wp/v2/posts ) all'URL radice REST del tuo sito web (http://www.acme_shop_2.onpressidium.com /wp-json/ ) formando l'URL che vedi sullo schermo.
Fare clic sul pulsante Invia .

Se tutto va bene, sarai in grado di vedere la risposta JSON del tuo sito web nella scheda Corpo sottostante. Puoi sperimentare diversi percorsi di base e verbi consultando la documentazione. L'API REST di WordPress è qualcosa di cui ci occuperemo nei post futuri, in cui ne faremo ampio uso, in articoli più orientati agli sviluppatori.

Il futuro di WordPress è luminoso!

Nel corso degli anni, WordPress si è evoluto notevolmente e ha offerto nuove possibilità agli utenti. A tutti, dai singoli blogger, giornalisti, editori ai proprietari di aziende e ora agli sviluppatori di software di altre comunità open source. WordPress continua a potenziare i suoi utenti. Continua a dare l'esempio di ciò che le persone possono ottenere quando sono guidate dalla stessa passione, ma provengono da background diversi. La sua integrazione con l'API REST nel core di WordPress non solo apre un nuovo mondo di possibilità, ma crea anche un nuovo mondo di complessità . Questo è ciò di cui tratta davvero la nostra soluzione di hosting WordPress gestita, questo è il nostro contributo alla comunità. Si tratta di abilitare te e la tua impresa quotidiana . Si tratta di combattere tutta quella complessità, mantenere tutto in esecuzione e ronzare ed essere lì, quando le cose, inevitabilmente, si romperanno.