Che cos'è l'API REST di WordPress e come la usi?

Probabilmente hai sentito parlare dell'API REST. Forse hai sentito che gli utenti di WordPress ne traggono vantaggio. Ma potresti anche chiederti cos'è esattamente un'API di WordPress.

Capire come funzionano le API non è così complicato come sembra. Continua a leggere per scoprire cos'è un'API, cos'è l'API REST e come puoi utilizzare l'API REST di WordPress nei tuoi siti.

Che cos'è un'API?

Un'Application Program Interface (API) è un modo in cui due applicazioni possono "comunicare" tra loro. Un sistema fa una richiesta e l'altro la soddisfa. Le richieste che un sistema accetta devono essere incluse nell'API, altrimenti la richiesta non può essere soddisfatta.

Pensaci in questo modo. Forse hai davvero fame, quindi vai a Waffle House. Ordini caffè, uova e frittelle. La cameriera inizia a scrivere il tuo ordine e poi si confonde quando arrivi ai pancake. Waffle House non serve frittelle. Servono solo waffle.

Un sistema che richiede frittelle da un menu API che serve solo waffle rimarrà affamato.

Che cos'è l'API REST?

Quando diciamo API REST, parliamo di un sistema di vincoli progettato per Internet. Descrive come un sito Web può richiedere informazioni da un altro sito Web in modo scalabile e uniforme. REST sta per Representational State Transfer, che è stato definito da Roy Fielding nella sua tesi di dottorato.

Che cos'è l'API REST di WordPress?

L'API REST di WordPress si riferisce alle richieste effettuate a un sito Web in esecuzione su WordPress. Se richiediamo un elenco di post o pagine, possiamo aspettarci di ricevere tali informazioni dall'API REST di WordPress. WordPress non fornirà mai informazioni che non siano rese pubbliche, come bozze di post o (cosa più importante) password utente.

Questo è fondamentale per il Block Editor, che scambia i dati in modo dinamico con WordPress senza ricaricare la pagina. Ogni endpoint restituisce dati in un formato JSON leggibile da JavaScript, o in questo caso blocchi.

Tieni presente che l'API REST è solo una delle API fornite da WordPress. Esistono anche, ad esempio, l'API del database e l'API dei metadati, che vengono utilizzate dai plugin per interagire con WordPress sul server. Puoi saperne di più sulle API di WordPress nel Codex.

Come funziona una richiesta API REST di WordPress?

Esistono alcune parti di base dell'API REST, vale a dire: percorsi, endpoint, richieste e risposte.

Itinerari

Un percorso è il modo in cui facciamo riferimento all'URL con cui comunica il sito web. Un percorso comune in WordPress è "/wp-admin". Sebbene non sia un percorso dell'API REST, è un percorso utilizzato dal browser per accedere al dashboard di amministrazione di WordPress. Per i nostri scopi, i percorsi dell'API REST iniziano con "/wp-json" (con JSON che è il formato standard dei dati).

Punti finali

Un endpoint è la combinazione di una route e del tipo di richiesta in entrata. Una singola route può connettersi a più endpoint, poiché esistono più tipi di richiesta. I tipi di richiesta comuni includono GET (come leggiamo i dati su un percorso) e POST (come aggiorniamo i dati su un percorso).

Richieste e risposte

Ogni comunicazione con l'API REST è inserita tra una richiesta e una risposta. Un sistema effettua una richiesta a cui risponde l'altro sistema. L'API REST di WordPress include oggetti utili per i plug-in per accedere ai dati della richiesta (WP_REST_Request) e gestire i dati di risposta (WP_REST_Response) durante l'estensione dell'API REST di WordPress.

Come installare l'API REST in WordPress

A partire dalla versione 4.7 di WordPress, WordPress include l'API REST come funzionalità principale.

Se stai eseguendo una versione precedente, puoi installare il plug-in della funzione json-rest-api. Questo è stato utilizzato per sviluppare l'API REST prima di essere completamente integrato con la base di codice di WordPress. Questo plugin è tecnicamente chiuso, quindi ti consigliamo di aggiornare invece la tua versione di WordPress (o magari considerare Managed WordPress Hosting e sarai sempre aggiornato.)

Esempi di API REST di WordPress

Dai un'occhiata al sito web di GiveWP. Se vai sul loro blog, sarai in grado di vedere le notizie e i post recenti. Questo percorso rende l'HTML, che è bello da vedere, ma con cui è difficile interagire per un programmatore. Invece, i post vengono resi disponibili ai programmatori utilizzando il percorso "/wp-json/wp/v2/posts".

Il percorso "/wp-json/wp/v2/posts" ci dice che questa è una risorsa WordPress ("/wp"), che questa è la versione 2 ("/v2/") della risorsa e in particolare che si tratta di post ("/post"). Se non l'hai già fatto, visita https://givewp.com/wp-json/wp/v2/posts e confronta ciò che vedi con https://givewp.com/blog/. Ti darò un suggerimento: sono le stesse informazioni!

Per un esempio di come viene utilizzata l'API REST all'interno di WordPress, considera il blocco dei post più recenti. Per ottenere un elenco di post in WordPress, il sito dovrebbe tradizionalmente fare una richiesta al server e quindi eseguire nuovamente il rendering dell'intera pagina.

Il blocco dei post più recenti può richiedere solo i post e quindi eseguire nuovamente il rendering. Lo fa usando l'API REST. E può farlo più volte per sondare nuovi post, senza eseguire nuovamente il rendering dell'intera pagina. Ciò è particolarmente utile quando si considera la modifica completa del sito in cui i blocchi vengono utilizzati per modificare e visualizzare i componenti della pagina.

Ogni singolo componente può richiedere i dati di cui ha bisogno (incluso il controllo degli aggiornamenti) e quindi eseguire nuovamente il rendering solo di ciò che è cambiato.

Ora sai

Ora che ottieni lo scopo e la struttura di un'API REST di WordPress, dai un'occhiata per vedere cosa puoi trovare da solo. Per una panoramica completa sull'utilizzo e l'estensione dell'API REST di WordPress, consulta il Manuale dell'API REST.

Ricorda: se qualcuno ti chiede informazioni sulle API, non puoi ordinare i pancake da Waffle House.

Mentre stai perfezionando il tuo sito, non dimenticare che i siti migliori hanno bisogno di un ottimo hosting. Ottieni tutto questo con Managed WordPress di Nexcess. Con potenti velocità, opzioni di scalabilità e supporto eccezionale, puoi fare affidamento su Nexcess per potenziare il tuo sito WordPress.

Vieni a scoprire perché il meglio è integrato con Nexcess. Dai un'occhiata ai nostri piani di hosting completamente gestiti WordPress oggi.

Risorse WordPress correlate

• WordPress.com vs WordPress.org
• 5 tecniche avanzate per velocizzare il tuo sito WordPress
• Cos'è l'hosting WordPress?
• La guida essenziale ai plugin di WordPress
• Come scegliere un host web: cosa cercare e cosa evitare