Che Cos’\u00e8 la REST API di WordPress?<\/h2>\n
La REST API di WordPress \u00e8 un’interfaccia che gli sviluppatori<\/a> possono utilizzare per accedere a WordPress dall’esterno dell’installazione. \u00c8 possibile accedervi utilizzando JavaScript, il che significa che pu\u00f2 essere utilizzata per creare siti web e applicazioni interattive.<\/p>\n REST sta per Representational State Transfer e API sta per Application Programming Interface. Vediamo cosa significano entrambi.<\/p>\n Un’Application Programming Interface, o API, \u00e8 definita<\/a> come segue:<\/p>\n “Un’interfaccia o protocollo di comunicazione tra un client e un server per semplificare la costruzione di software lato client.”<\/p><\/blockquote>\n Se non si ha familiarit\u00e0 con le API, questa definizione potrebbe non essere di grande aiuto. Per metterla in modo pi\u00f9 semplice, un’API \u00e8 un insieme di istruzioni che permette ad un sistema di interagire (o “interfacciarsi”) con un altro. Se avete mai aggiunto una mappa di Google al vostro sito WordPress<\/a> , avete usato l’API di Google Maps, che permette al vostro sito WordPress di interfacciarsi con le maoppe di Google.<\/p>\n Questi sistemi non devono essere completamente separati. WordPress ha gi\u00e0 pi\u00f9 API<\/a> per cose come plugin<\/a>, impostazioni e shortcode<\/a>. Queste API possono essere utilizzate dagli sviluppatori di plugin e temi per interagire con il core di WordPress e far succedere delle cose (come la creazione di scorciatoie e l’aggiunta di schermate di impostazioni per il pannello di amministrazione di WordPress).<\/p>\n La differenza con la REST API \u00e8 che questa permette a sistemi esterni all’installazione di WordPress di interagire con WordPress, cosa in cui entra in azione la parte REST.<\/p>\n Il Representational State Transfer, o REST, fornisce standard che i sistemi web possono utilizzare per interfacciarsi tra loro. Senza REST, due sistemi non sarebbero in grado di capirsi e quindi di inviare dati in un senso o nell’altro.<\/p>\n Affinch\u00e9 un’applicazione sia RESTful<\/a>, deve essere conforme a cinque principi:<\/p>\n Tutti questi vincoli riguardano le pagine web e le applicazioni e regolano il modo in cui un’applicazione pu\u00f2 interfacciarsi con l’API.<\/p>\n Mettere insieme REST e API significa che la REST API \u00e8 un insieme di istruzioni codificate per consentire ad altri sistemi di interfacciarsi con WordPress e che \u00e8 programmate in modo tale da garantire che questi sistemi si capiscano a vicenda.<\/p>\n Significa che un sito web di terze parti o un’applicazione mobile, ad esempio, pu\u00f2 accedere al vostro database WordPress<\/a>, recuperarne e aggiungere dati.<\/p>\n Ci sono per\u00f2 una serie di implicazioni e di utilizzi.<\/p>\n La REST API di WordPress \u00e8 stata sviluppata in risposta ai cambiamenti nel modo in cui vengono sviluppati i siti web e le applicazioni e alla necessit\u00e0 di aprire WordPress in modo pi\u00f9 esteso.<\/p>\n La REST API di WordPress \u00e8 stata rilasciata<\/a> a dicembre 2016 come parte del core della versione 4.7, ma c’era gi\u00e0 prima come plugin.<\/p>\n \u00c8 progettata per supportare una serie di applicazioni basate su WordPress e per trasformare WordPress da sistema di gestione dei contenuti<\/a> a piattaforma per applicazioni.<\/p>\n \u00c8 ampiamente utilizzata da WordPress.com<\/a>, la cui interfaccia basata su JavaScript utilizza la REST API per interfacciarsi con il database di WordPress. Viene utilizzato anche dall’interfaccia di editing di Gutenberg<\/a>, che \u00e8 entrata a far parte del core nel 2019.<\/p>\n La REST API amplia la gamma di applicazioni per le quali \u00e8 possibile utilizzare WordPress. Mentre un sistema di gestione dei contenuti \u00e8 eccellente per il funzionamento di un sito web complesso, una application platform pu\u00f2 essere utilizzata anche come base per applicazioni web-based a pagina singola o per SPA (se avete mai utilizzato Google docs<\/a>, allora ne avete conosciuto uno).<\/p>\n In queste applicazioni, il contenuto viene aggiornato quando l’utente esegue un’azione, invece di caricare nuove pagine. Dato che utilizza JavaScript (un linguaggio lato client) invece di PHP<\/a> (un linguaggio lato server), pu\u00f2 far succedere le cose nel browser dell’utente senza dover inviare costantemente richieste al server.<\/p>\n Se siete utenti e\/o sviluppatori che lavorano con WordPress, la REST API comporta diverse cose.<\/p>\n Per gli utenti ricordiamo:<\/p>\n Per gli sviluppatori ci sono implicazioni e possibilit\u00e0 pi\u00f9 ampie:<\/p>\n Nel tempo, la REST API di WordPress far\u00e0 s\u00ec che una parte maggiore del core di WordPress sar\u00e0 scritto in JavaScript invece che in PHP. Se siete sviluppatori WordPress, questo significa che dovrete apprendere JavaScript.<\/p>\n Come si accede alla REST API di WordPress?<\/p>\n Per accedere all’API WP-REST, \u00e8 necessario accedere al sito tramite la linea di comando. In WordPress questa si chiama WP-CLI<\/a> . Non \u00e8 possibile fare nulla di tutto questo attraverso il pannello di amministrazione o accedendo direttamente al codice del vostro sito.<\/p>\n Vediamo come iniziare.<\/p>\n WP-CLI \u00e8 l’interfaccia a riga di comando di WordPress. Consente di accedere e lavorare con WordPress tramite l’interfaccia a riga di comando (CLI) del computer. WP-CLI \u00e8 preinstallato con tutti i piani di hosting di Kinsta.<\/p>\n Per accedere alla CLI, aprite il Terminale su Mac o in Linux, o il Prompt dei comandi in Windows.<\/p>\n Per accedere a un sito remoto tramite WP-CLI, \u00e8 necessario accedere al server via SSH<\/a> (Non potete connettervi via SSH? Correggette l\u2019errore SSH \u201cConnection Refused\u201d<\/a>).<\/p>\n Per accedere a un sito locale<\/a>, \u00e8 sufficiente utilizzare la corretta struttura delle directory dalla riga di comando. \u00c8 una buona idea sperimentare con le API REST su un sito di test locale prima di provarlo su un sito live.<\/p>\n Dovrete accedere specificamente alla REST API del vostro sito in questo modo:<\/p>\n Potrete quindi aggiungere elementi per accedere ad alcuni tipi di dati, che esamineremo pi\u00f9 nel dettaglio a breve. Questi elementi sono chiamati endpoint.<\/p>\n Una volta effettuato l’accesso al sito, potrebbe essere necessario effettuare l’autenticazione. Alcuni endpoint sono pubblici e non richiedono autenticazione, altri la richiedono.<\/p>\n Qui non state effettuando l’accesso al pannello di amministrazione del vostro sito<\/a>: la REST API fa le cose un po’ diversamente.<\/p>\n Per autenticare il sito tramite WP-CLI, \u00e8 necessario installare un plugin di autenticazione. Per le installazioni di sviluppo, il plugin Basic Auth<\/a> fa il suo lavoro ed \u00e8 semplice da usare.<\/p>\n Tuttavia, per i siti live, si dovrebbe usare una sistema pi\u00f9 solido di autenticazione, come il plugin JWT Authentication<\/a> , che utilizza JSON Web Token ed \u00e8 pi\u00f9 sicuro.<\/p>\n Potrete quindi utilizzare la riga di comando per accedere ai dati con autenticazione.<\/p>\n L’esempio che segue utilizza Le bozze degli articoli non sono informazioni pubbliche, quindi per accedervi \u00e8 necessaria l’autenticazione. Ma se state cercando dati pubblici, non avete bisogno di autenticazione. Quindi, per recuperare un elenco dei messaggi che sono stati pubblicati, \u00e8 possibile utilizzare:<\/p>\n Questo andrebbe a prendere tutti i post pubblicati, proprio perch\u00e9 sono pubblici.<\/p>\n Una volta che siete entrati nel vostro sito e sapete come utilizzare l’autenticazione (e se \u00e8 necessaria), dovrete utilizzare uno dei tanti comandi per interagire con il sito.<\/p>\n I comandi da utilizzare sono:<\/p>\n Diamo un’occhiata ad ognuno di questi comandi.<\/p>\n Il comando Notate che non ho incluso il percorso completo del sito nella riga qui sopra, in quanto avete gi\u00e0 avuto accesso tramite WP-CLI.<\/p>\n Una volta recuperati questi dati, potrete utilizzarli come informazioni per il vostro passo successivo. Potreste cancellare uno di questi messaggi, modificarlo o aggiornarlo. Oppure potete semplicemente inviare i post alla vostra applicazione web.<\/p>\n Diciamo che volete recuperare l’ultimo post. Dovreste utilizzare questo comendo:<\/p>\n Ci sono una serie di argomenti che potete utilizzare quando lavorate con i post. Si veda il manuale della REST API di WordPress<\/a> per maggiori informazioni.<\/p>\n Utilizzate Quindi, ad esempio, se volete creare un post, potete iniziare con un comando In questo modo si crea una bozza vuota di articolo.<\/p>\n Potrete quindi aggiornare il post utilizzando un comando Con un comando Per aggiungere una pagina al vostro sito, potreste utilizzare qualcosa del genere:<\/p>\n Questo creerebbe una pagina vuota allo stesso modo in cui si crea un post vuoto.<\/p>\n Il comando Diciamo che avete un certo numero di bozze di articoli nel vostro sito. Volete controllarli e aggiornarne uno per pubblicarlo.<\/p>\n Potreste iniziare cercando una lista di tutte le bozze di post:<\/p>\n Il sistema vi fornir\u00e0 un elenco di tutte le bozze degli articoli correnti. \u00c8 possibile modificare lo stato di uno di questi utilizzando il suo ID:<\/p>\n Questo accede a quel post e vi permette di modificarlo. Potrete quindi modificarne lo stato utilizzando l’argomento status:<\/p>\n Oppure potete aggiungere contenuti al post e pubblicarlo:<\/p>\n Il server restituir\u00e0 uno stato Il comando Quindi, se voleste spostare il post appena creato nel cestino, dovreste utilizzare questo comando:<\/p>\n Tuttavia, se si volesse bypassare il cestino e cancellarlo definitivamente, si dovrebbe utilizzare l’argomento Questo cancella permanentemente il messaggio senza possibilit\u00e0 di annullamento, quindi deve essere utilizzato con cautela.<\/p>\n La REST API di WordPress non \u00e8 sempre lo strumento giusto per sviluppare un sito web o un’applicazione. Ecco alcune considerazioni di cui dovreste essere consapevoli prima di utilizzarla per lo sviluppo:<\/p>\n Se la vostra applicazione sar\u00e0 utilizzata su dispositivi che non eseguono JavaScript o da utenti che possono averla disattivata, allora non funzioner\u00e0 con la REST API.<\/p>\n Un sito WordPress in PHP genera codice HTML, quindi non soffre di questo problema. I dispositivi che non utilizzano JavaScript sono sempre pi\u00f9 rari, ma se si sviluppa specificamente per questi dispositivi, la REST API non funzioner\u00e0.<\/p>\n Allo stesso modo, se \u00e8 possibile che gli utenti disattivino JavaScript, allora lavorare con le API REST causer\u00e0 dei problemi. Alcuni utenti disattivano JavaScript nel loro browser per motivi di accessibilit\u00e0 o di sicurezza.<\/p>\n Siti e applicazioni sviluppate con JavaScript non sono sempre accessibili come quelli in HTML.<\/p>\n Questo \u00e8 dovuto in gran parte al modo in cui JavaScript viene utilizzato per fornire contenuti dinamici che potrebbero non andar bene con gli screen reader e potrebbero causare problemi alle persone con disabilit\u00e0 visive o epilessia fotosensibile.<\/p>\n Utilizzare la REST API per accedere al vostro sito WordPress e produrre dati in una forma progettata per essere accessibile significa che potete superare questi problemi, ma vale la pena verificare l’accessibilit\u00e0 del vostro sito mentre siete in sviluppo.<\/p>\n Le applicazioni a pagina singola, che si aggiornano frequentemente, possono talvolta causare problemi di SEO<\/a> . Questo perch\u00e9 il contenuto che non viene consegnato quando la pagina viene visualizzata per la prima volta potrebbe non essere indicizzato dai motori di ricerca.<\/p>\n Google e altri motori di ricerca<\/a> stanno recuperando il ritardo con il fatto che molti siti web sono ora alimentati da SPA e li stanno indicizzando in modo appropriato. Ma vale la pena di fare una verifica SEO<\/a> approfondita di qualsiasi sito sviluppato utilizzando la REST API.<\/p>\n Se non volete che le applicazioni siano in grado di accedere ai dati del vostro sito utilizzando la REST API, potete disattivarla. Ricordate che i dati pubblici potrebbero essere accessibili a chiunque, non solo a voi.<\/p>\n Per farlo, \u00e8 possibile installare il plugin Disable WP REST API<\/a> . Questo plugin disabilita la REST API per chiunque non sia connesso al vostro sito.<\/p>\n In alternativa, potete aggiungere del codice al file functions del tema o scrivere un vostro plugin. \u00c8 meglio scrivere un plugin in quanto non si tratta di funzionalit\u00e0 specifiche del tema.<\/p>\n Nel plugin aggiungete solo due righe:<\/p>\n Questo disabiliter\u00e0 completamente la REST API per il vostro sito. Potrebbe avere effetti a catena per le schermate di amministrazione, quindi accertatevi che tutto funzioni correttamente dopo aver attivato il plugin.<\/p>\n La REST API presenta alcune interessanti possibilit\u00e0 per il futuro di WordPress. Ecco alcuni esempi di applicazioni e siti che utilizzano la REST API di WordPress per creare SPA o per collegare WordPress ad altri siti e tecnologie.<\/p>\n Le schermate di amministrazione di WordPress.com sono costruite interamente utilizzando la REST API per fornire una SPA con cui gli utenti interagiscono per gestire il proprio sito.<\/p>\n Questo rende dinamica la comunicazione tra l’interfaccia e il server e si traduce in un’interfaccia user-friendly che WordPress.org adotta nel tempo.<\/p>\n Anche questo si trova nelle schermate di amministrazione di WordPress, ma questa volta anche nelle installazioni indipendenti di WordPress, l’editor a blocchi di Gutenberg utilizza la REST API per comunicare con il vostro database e creare blocchi.<\/p>\n Affinch\u00e9 i tipi di post funzionino con l’editor Gutenberg, la REST API deve essere abilitata. Il che significa che, se state registrando un custom post type<\/a> e state utilizzando Gutenberg, dovrete aggiungere la seguente riga per abilitare l’editor a blocchi per quel tipo di post:<\/p>\n Event Espresso<\/a> \u00e8 un plugin WordPress che permette agli utenti di organizzare e pubblicizzare eventi. Utilizza la REST API in modo che gli utenti possano accedere ai dati dall’esterno di WordPress. Questo significa che potete costruire app mobili o SPA per gestire i vostri eventi.<\/p>\n UsTwo<\/a> \u00e8 un’agenzia digitale il cui sito \u00e8 stato realizzato utilizzando la REST API come applicazione a pagina singola. Questo combina un front-end costruito utilizzando React con un backend alimentato da WordPress (lettura suggerita: Una Guida Per Avviare e Gestire un\u2019Agenzia WordPress di Successo<\/a>).<\/p>\n Il contenuto della pagina singola \u00e8 modulare, con una struttura diversa da quella di una pagina WordPress standard. Per fare questo lavoro, utilizzano un plugin personalizzato per la creazione di pagine che permette al loro team di aggiungere contenuti modulari al sito.<\/p>\n Il sito web di USA Today<\/a> \u00e8 stato ricostruito integrando la REST API di WordPress con i sistemi e i moduli esistenti nel sito.<\/p>\n La REST API ha permesso che il contenuto del sito fosse esteso ad altri punti vendita come Facebook Instant Articles<\/a> e Apple News, utilizzando JSON. Hanno anche sviluppato un social game online per la loro sezione sportiva, costruito utilizzando JavaScript.<\/p>\n\nCos’\u00e8 una Application Programming Interface (API)?<\/h3>\n
Che cos’\u00e8 il Representational State Transfer (REST)?<\/h3>\n
\n
Cosa Significa Questo per WordPress?<\/h3>\n
Capire la REST API di WordPress<\/h2>\n
Lo Sfondo alla REST API di WordPress<\/h3>\n
Implicazioni per gli Utenti e gli Sviluppatori di WordPress<\/h3>\n
\n
\n
Come accedere all’API WordPress REST API<\/h2>\n
Accedere a WP-REST via WP-CLI<\/h3>\n
![\"Terminale](\"https:\/\/kinsta.com\/it\/wp-content\/uploads\/sites\/2\/2019\/10\/Terminale-su-Mac-1.jpg\")
http:\/\/yoursite.com\/wp-json\/wp\/v2<\/code><\/pre>\nAutenticazione<\/h3>\n
curl<\/code> per testare la connessione a WordPress. Si otterr\u00e0 un elenco di bozze di articoli.<\/p>\ncurl -X GET --user username:password -i http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts?status=draft<\/code><\/pre>\ncurl -X GET http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts<\/code><\/pre>\nPanoramica dei Comandi della REST API di WordPress<\/h2>\n
\n
GET<\/code> recupera una risorsa come un post o altri dati.<\/li>\nPOST<\/code> aggiunge una risorsa al server, come un post, un allegato o un’altra risorsa.<\/li>\nPUT<\/code> pu\u00f2 essere utilizzato per modificare o aggiornare una risorsa gi\u00e0 presente sul server.<\/li>\nDELETE<\/code> rimuove una risorsa dal server. Usatelo con prudenza!<\/li>\n<\/ul>\nGET<\/h3>\n
GET<\/code> \u00e8 probabilmente il pi\u00f9 utilizzato: questo comando recupera i dati. L’esempio (che si utilizza una volta che si accede con successo al proprio sito) che segue riporta un elenco di tutte le pagine pubblicate nel vostro sito:<\/p>\nGET http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/?status=published<\/code><\/pre>\nGET http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/?per_page=1<\/code><\/pre>\nPOST<\/h3>\n
POST<\/code> per aggiungere dati o risorse al vostro sito.<\/p>\nPOST<\/code>:<\/p>\nPOST http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/<\/code><\/pre>\nPUT<\/code> per modificarlo.<\/p>\nPOST<\/code> potete anche aggiungere altre risorse, oltre agli articoli, come allegati e altri tipi di post.<\/p>\nPOST http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/pages<\/code><\/pre>\nPUT<\/h3>\n
PUT<\/code> consente di modificare una risorsa esistente, compresi i post.<\/p>\nPOST http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/?status=\"draft\"<\/code><\/pre>\nPUT \/wp\/v2\/posts\/567<\/code><\/pre>\n{\n\"status\" = \"publish\"\n}<\/code><\/pre>\n{\n\"status\" = \"publish\"\n\"content\" = \"content here\"\n}<\/code><\/pre>\n200 - OK<\/code> che vi dice che la richiesta PUT ha modificato con successo il messaggio.<\/p>\nDELETE<\/h3>\n
DELETE<\/code> fa quello che ci si aspetterebbe: cancella una risorsa. Di default, se lo utilizzate per eliminare un post, il comando lo sposter\u00e0 nel cestino invece di cancellarlo definitivamente.<\/p>\nDELETE http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/567<\/code><\/pre>\nforce<\/code>:<\/p>\nDELETE http:\/\/yoursite.com\/wp-json\/wp\/v2\/posts\/567?force=true<\/code><\/pre>\nQuando non Utilizzare la REST API di WordPress<\/h2>\n
Compatibilit\u00e0<\/h3>\n
Accessibilit\u00e0<\/h3>\n
SEO<\/h3>\n
Come Disattivare la REST API di WordPress<\/h3>\n
![\"Disable](\"https:\/\/kinsta.com\/it\/wp-content\/uploads\/sites\/2\/2019\/12\/disabilita-wp-rest-api.jpg\")
add_filter( 'json_enabled', '__return_false' );\nadd_filter( 'json_jsonp_enabled', '__return_false' );\n<\/code><\/pre>\nApplicazioni del Mondo Reale che Utilizzano la REST API di WordPress<\/h2>\n
WordPress.com<\/h3>\n
![\"L'interfaccia](\"https:\/\/kinsta.com\/it\/wp-content\/uploads\/sites\/2\/2019\/10\/WordPressdotcom-interfaccia.jpg\")
L’Editor a Blocchi (Gutenberg)<\/h3>\n
![\"L'editor](\"https:\/\/kinsta.com\/it\/wp-content\/uploads\/sites\/2\/2019\/10\/editore-Gutenberg.jpg\")
\"show_in_rest\" = true;<\/code><\/pre>\nEvent Espresso<\/h3>\n
![\"Event](\"https:\/\/kinsta.com\/it\/wp-content\/uploads\/sites\/2\/2019\/10\/Event-Espresso.jpg\")
UsTwo<\/h3>\n
![\"UsTwo\"](\"https:\/\/kinsta.com\/it\/wp-content\/uploads\/sites\/2\/2019\/10\/UsTwo.jpg\")
USA Today<\/h3>\n
![\"USA](\"https:\/\/kinsta.com\/it\/wp-content\/uploads\/sites\/2\/2019\/10\/USA-today.jpg\")
Riepilogo<\/h2>\n