Un’Introduzione alla REST API di WordPress

Quando la REST API è stata finalmente aggiunta al core di WordPress, è stata la fine di un lungo viaggio. Molti avevano previsto questo cambiamento come il passo più grande in avanti per WordPress nella storia della piattaforma. Tuttavia, se non sei familiare con la REST API, potresti essere confuso riguardo al suo significato.

In breve, l’aggiunta dell’API REST di WordPress ha trasformato WordPress in un framework di applicazione completo. Questo ha aumentato significativamente la sua ‘estensibilità’, ovvero la sua capacità di essere ampliato con nuove funzionalità e capacità. Inoltre, ha espanso le potenzialità della piattaforma di comunicare con altri siti e applicazioni.

Introduzione Alle REST APIs

Prima di addentrarci più a fondo nell’API REST di WordPress, è importante chiarire la nostra terminologia. Questo è un argomento in cui dovremo usare molti acronimi, quindi risolviamoli subito.

Innanzitutto, devi sapere cosa sono le Application Programming Interfaces (API). In termini semplici, un’API è un mezzo attraverso il quale un sistema permette ad altri sistemi di connettersi ai suoi dati.

Per esempio, quando un sito web aggiunge un pulsante di ‘mi piace’ di Facebook a una pagina, lo fa collegandosi all’API di Facebook. Questo permette alla pagina web di utilizzare l’API per ricevere dati (il codice per il pulsante mi piace) e inviare dati (la richiesta di mi piace).

Allora, cos’è specificamente una REST API? Representational State Transfer (REST) è un tipo di API specifico per i servizi web. Contiene un insieme standardizzato di istruzioni e regole, rendendo più semplice la connessione tra tutti i servizi ‘RESTful’.

In breve, le REST APIs ti permettono di fare richieste a un sistema esterno. Un esempio di questo è Twitter. Puoi usare la sua API per richiedere un certo numero di tweet da un utente specifico. L’API restituirà poi i tweet basandosi sulla tua richiesta, che potrai incorporare nel tuo sito usando HTML e CSS.

Queste richieste vengono effettuate utilizzando la Notazione degli Oggetti JavaScript (JSON). Si tratta di un linguaggio specificamente progettato per l’invio, la ricezione e l’archiviazione dei dati.

Tratteremo JSON più avanti in questo articolo, ma ti consigliamo di prenderti del tempo per familiarizzare in anticipo con questo linguaggio. Questo ti aiuterà a prepararti per l’uso della WordPress REST API e a comprendere alcuni dei concetti di cui parleremo.

Cos’è l’API REST di WordPress (E Perché È Importante)

L’API REST di WordPress funziona in gran parte allo stesso modo degli esempi che abbiamo già trattato. Fondamentalmente, l’API REST di WordPress ti offre l’accesso completo alle funzionalità di WordPress da qualsiasi Framework compatibile con JSON.

Allo stesso modo in cui l’API di Twitter ti permette di recuperare e inviare tweet, l’API REST di WordPress può essere utilizzata per gestire post, utenti, categorie e molto altro da piattaforme esterne. Ti consente di utilizzare WordPress in modi prima inediti.

L’API REST è stata annunciata nel lontano 2013. È iniziata come un plugin, destinato ad essere incorporato nel nucleo di WordPress dalla Versione 4.1. Come spesso accade, i ritardi hanno spostato il rilascio fino a quando non è stato finalmente implementato nel nucleo con il rilascio di WordPress 4.7 tre anni dopo.

Questa è stata un’attesa lunga ma proficua per molte persone che vedevano l’API REST di WordPress come un passo importante avanti per la piattaforma. Potresti chiederti perché questa aggiunta è stata così importante, specialmente dato che molti utenti probabilmente non hanno notato molta differenza. Come si è scoperto, l’inclusione dell’API REST è stata una modifica fondamentale per WordPress per molteplici motivi.

Implementando una REST API, WordPress ha fatto un passo avanti rispetto al semplice essere una piattaforma per la creazione di siti web. Ora è diventato un framework di applicazioni a tutti gli effetti. Questo significa che gli sviluppatori possono utilizzare un sito WordPress per creare applicazioni per dispositivi mobili e il web o come repository di informazioni.

Questo cambiamento ha anche permesso a WordPress di allontanarsi dalla sua dipendenza da PHP. Rendendo WordPress compatibile con qualsiasi linguaggio compatibile con JSON, la REST API ha notevolmente ampliato le possibilità per gli sviluppatori, permettendo loro di utilizzare le funzionalità di WordPress con praticamente qualsiasi framework.

Infine, l’API REST offre maggiore flessibilità con le interfacce che puoi utilizzare per lavorare con la piattaforma. Ha reso l’interfaccia di amministrazione completamente opzionale, poiché ora puoi interagire con il tuo sito WordPress interamente tramite comandi JSON.

Ora, vediamo come JSON e l’API REST si uniscono per rendere ciò possibile.

Come Funzionano Insieme l’API REST e JSON

Ormai dovresti avere una conoscenza teorica dell’API REST di WordPress. Quindi, esaminiamo il lato più pratico della tecnologia. Il manuale ufficiale descrive l’uso dell’API REST come segue:

“L’API REST di WordPress fornisce endpoint API per i tipi di dati di WordPress che consentono agli sviluppatori di interagire con i siti da remoto, inviando e ricevendo oggetti JSON (JavaScript Object Notation).”

La prima parola su cui dobbiamo concentrarci qui è “endpoint”. Il modo più semplice per pensare a un endpoint è come a un pezzo di dati o a una funzione che può essere chiamata utilizzando una richiesta JSON. Di default, WordPress offre un enorme numero di endpoint standard da utilizzare, ma gli sviluppatori possono anche creare endpoint personalizzati.

Per raggiungere un endpoint, devi utilizzare una ‘route,’ che assume la forma di un URL normale. Puoi anche provare tu stesso in questo momento.

Vai al tuo sito WordPress e aggiungi /wp-json/wp/v2 alla fine del suo URL. Se il tuo sito è http://example.com, dovresti inserire http://example.com/wp-json/wp/v2.

Quando carichi questo percorso, raggiungerai l’endpoint, che in questo caso, restituisce tutti i contenuti e i meta-dati per il tuo sito in un formato JSON (disordinato). Utilizzando diversi percorsi, puoi accedere a differenti endpoint per ottenere tipi specifici di informazioni e svolgere varie attività.

Ci sono tre principali richieste JSON che utilizzerai con l’API REST, quindi diamo anche uno sguardo rapido a queste ora. Sono:

• GET. Questo tipo di richiesta è utilizzato per recuperare ed elencare i dati dall’API. Ad esempio, useresti una richiesta GET per restituire un elenco di utenti sul tuo sito o compilare post di blog da un certo periodo di tempo.
• POST. Questa richiesta è usata per inviare dati all’API. Ti permette di inserire nuove informazioni in WordPress, come aggiungere nuovi utenti e post o aggiornare i dati esistenti.
• DELETE. Come suggerisce il nome, questa richiesta è utilizzata per eliminare dati. Questo ti permette di rimuovere post, pagine, utenti e altro.

GET e POST possono a volte essere utilizzati con lo stesso endpoint per ottenere risultati diversi.

Ad esempio, esaminiamo l’endpoint /me/settings/. Se eseguissi una richiesta GET su questo endpoint, riceveresti un elenco delle impostazioni dell’utente corrente. Tuttavia, utilizzando una richiesta POST sullo stesso endpoint, potresti aggiornare le impostazioni invece.

Per Iniziare con la WordPress REST API

Adesso metteremo in pratica tutta questa teoria e ti mostreremo alcuni esempi molto basilari di ciò che puoi fare con la REST API. Questo è solo un assaggio per aiutarti a diventare familiare con l’utilizzo della REST API per elaborare richieste a WordPress.

Per altri esempi, ti consigliamo di consultare la biblioteca di riferimento ufficiale e le Risorse REST API.

Le seguenti tecniche richiederanno l’uso della linea di comando per elaborare richieste JSON. Questo ti permette di interagire con il tuo sito WordPress utilizzando un’interfaccia basata su testo e inviando comandi semplici.

Se non hai esperienza nell’uso della linea di comando, ti consigliamo di dedicare del tempo per imparare le basi prima. Potresti anche voler utilizzare SSH per creare la connessione con il tuo sito.

Finalmente, quando sei pronto, diamo un’occhiata ad alcuni esempi di come puoi utilizzare l’API REST di WordPress!

1. Restituisci Post da un Sito

Mentre ovviamente avrai bisogno dell’autorizzazione appropriata per modificare un sito web, è possibile recuperare alcune informazioni da quasi qualsiasi sito WordPress. Questo perché la REST API è consistente in tutte le installazioni di WordPress.

Come abbiamo discusso, il motivo principale per cui esistono le API è permettere alle applicazioni esterne di accedere ad alcuni dei tuoi dati. In questo esempio, possiamo recuperare un singolo post dal blog ufficiale delle novità di WordPress:

curl https://wordpress.org/news/wp-json/wp/v2/posts/1

L’ID è stato impostato su 1, il che significa che questa richiesta recupererà il primissimo post sul blog. Potrebbe essere difficile da vedere poiché il JSON non è molto leggibile, ma tra il codice, puoi individuare tutto il contenuto e i meta-dati del post:

Potresti quindi utilizzare queste informazioni in un’applicazione, ad esempio, per visualizzarle con il tuo stile personalizzato.

Se vuoi restituire tutti i post del blog, tutto ciò che devi fare è rimuovere l’ID alla fine. Tuttavia, è più probabile che tu voglia restituire un numero selezionato di post. La seguente richiesta restituirà gli ultimi tre post:

curl https://wordpress.org/news/wp-json/wp/v2/posts/?per_page=3

Puoi provare questo anche tu con altri siti, e persino con il tuo blog.

2. Aggiorna un Post

Ora, proviamo a fare alcune modifiche a WordPress usando la REST API. Per fare ciò, devi essere loggato nel sito che vuoi gestire. Ad esempio, se stai usando SSH, devi fare il login al tuo server.

In questo esempio, aggiorniamo un post esistente. Per prima cosa, usiamo una richiesta per aggiornare il titolo del post con l’ID di 1:

curl -X POST http://example.com/wp-json/wp/v2/posts/1 -d '{"title":"Un Nuovo Titolo"}'

Questo è abbastanza autoesplicativo. L’argomento del titolo mostra che stai aggiornando il titolo del post, seguito dalla stringa di testo contenente la sostituzione.

Ci sono numerosi altri argomenti che puoi utilizzare per apportare modifiche a un post. Ad esempio, puoi usare un elenco per assegnare categorie al post, pubblicarlo o modificarne completamente il contenuto.

3. Elimina un Utente

Infine, vediamo come puoi rimuovere dati usando la REST API. In questo esempio, procederemo a rimuovere un utente dal sito. Naturalmente, devi essere loggato e autorizzato a gestire gli utenti prima di poter utilizzare questa funzione.

Poi, puoi utilizzare la seguente richiesta per eliminare l’utente con un ID di 101:

curl -X DELETE http://example.com/wp-json/wp/v2/users/101

Questo rimuoverà l’utente specificato dal sito. Puoi usare i parametri aggiuntivi per riassegnare i post dell’utente a un altro utente in base al loro ID. In alternativa, puoi forzare una cancellazione permanente invece di aggiungere l’utente al cestino.

Attraverso questi esempi, puoi iniziare a vedere come l’API REST ti permetta di gestire i contenuti sul tuo sito e di connetterti con gli altri. Se desideri approfondire, ti consigliamo di esplorare il Manuale dell’API REST.

Esplora Lo Sviluppo Di WordPress

L’API REST di WordPress è stata un grande passo avanti per la piattaforma, lontano dalle sue origini e verso il futuro. I sviluppatori erano entusiasti fin dal primo giorno, ma se non eri familiare con le API REST inizialmente, potresti esserti chiesto il motivo.

Anche se l’API REST può sembrare complessa per i principianti, non devi essere uno sviluppatore esperto per utilizzare alcune richieste di base. Ad esempio, l’API ti permette di eseguire diverse operazioni sul tuo sito (o su altri), come restituire post, aggiornare post ed eliminare utenti.

Stai cercando un hosting ad alte prestazioni per il tuo sito WordPress? Su Dreamhost, i nostri piani gestiti DreamPress offrono ambienti di staging professionali, backup automatici, cache integrata e altro ancora. Scopri i nostri piani oggi stesso!