API REST di WordPress: che cos’è e come iniziare a usarlo
Se hai trascorso del tempo nella community di WordPress, è probabile che tu abbia sentito parlare della nuova API REST. Tuttavia, a meno che tu non sia uno sviluppatore esperto, potresti non avere alcuna idea di cosa sia effettivamente l’API REST di WordPress.
Sebbene i dettagli tecnici siano un po’ complessi, i concetti alla base di questa funzione sono abbastanza facili da comprendere.
La nuova API aiuta ad espandere le funzionalità di WordPress.
Inoltre, l’API REST rende più semplice agli sviluppatori la connessione di WordPress con altri siti e applicazioni.
In questa guida, ti guideremo attraverso tutte le nozioni di base.
Spiegheremo quali sono le API in generale e quali sono le API REST (e la versione specifica per WordPress).
Quindi, parleremo di come iniziare a utilizzare l’API REST di WordPress.
Bene non ci resta che iniziare !
Introduzione alle API (Application Programming Interface)
Prima di approfondire specificamente l’API REST, eseguiamo un po ‘di backup.
Per comprendere questo concetto, è fondamentale avere un’idea di base di ciò che le API sono in generale.
Un’interfaccia API o Application Programming Interface consente a due applicazioni di comunicare tra loro.
Ad esempio, quando visiti un sito Web, il browser invia una richiesta al server in cui si trova il sito.
L’API di quel server è ciò che riceve la richiesta del tuo browser, la interpreta e restituisce tutti i dati necessari per visualizzare il tuo sito.
C’è molto di più nel modo in cui le API funzionano in senso tecnico, naturalmente. Tuttavia, ci concentreremo su ciò che probabilmente conta di più per te: le applicazioni pratiche.
Le API hanno ricevuto molta attenzione e visibilità, perché molte aziende hanno iniziato a comprarle e a fornirle come prodotti.
In altre parole, gli sviluppatori di un’azienda come Google raccoglieranno alcune parti del codice della loro applicazione e la renderanno disponibile pubblicamente. In questo modo, altri sviluppatori possono utilizzare l’API come strumento per aiutare i propri siti a connettersi a Google e sfruttare le sue funzionalità.
Ad esempio, potresti utilizzare l’API di Google Maps per posizionare una mappa completamente funzionante sul tuo sito che beneficia di tutti i dati e le funzionalità pertinenti di Google. Questo ti evita di dover programmare una mappa e raccogliere una montagna di dati.
Lo stesso vale per un’ampia gamma di siti e applicazioni.
Man mano che i siti web e le funzionalità su cui si basano diventano più complessi, strumenti come le API diventano cruciali. Permettono agli sviluppatori di sfruttare le funzionalità esistenti, rendendo possibile semplicemente “collegare” nuove funzionalità al tuo sito web. A sua volta, il sito che possiede l’API beneficia dell’aumento dell’esposizione e del traffico.
Le regole fondamentali di un’API REST
Esistono molti modi per creare un’API. Un’API REST (Representational State Transfer) è un tipo particolare sviluppato in base a regole specifiche. In altre parole, REST presenta una serie di linee guida che gli sviluppatori possono utilizzare durante la creazione di API. Ciò garantisce che le API funzionino in modo efficace.
Per capire come funzionano le API REST, è quindi necessario sapere quali regole (o “vincoli”) funzionano sotto. Esistono cinque elementi di base che rendono un’API “RESTful”. Tieni presente che il ‘server’ è la piattaforma a cui appartiene l’API e il ‘client’ è il sito, l’applicazione o il software che si connette a quella piattaforma:
- Architettura client-server. L’API dovrebbe essere costruita in modo che il client e il server rimangano separati l’uno dall’altro. In questo modo possono continuare a svilupparsi da soli e possono essere usati indipendentemente.
- Apolidia. Le API REST devono seguire un protocollo ‘senza stato’. In altre parole, non possono memorizzare alcuna informazione sul client sul server. La richiesta del cliente dovrebbe includere tutti i dati necessari in anticipo e la risposta dovrebbe fornire tutto ciò di cui il cliente ha bisogno. Questo rende ogni interazione un affare “fatto e fatto” e riduce sia i requisiti di memoria che il potenziale di errori.
- Cache. Una ‘cache’ è la memoria temporanea di dati specifici, quindi può essere recuperata e inviata più velocemente. Le API RESTful utilizzano i dati memorizzabili nella cache quando possibile, per migliorare la velocità e l’efficienza. Inoltre, l’API deve consentire al client di sapere se ogni dato può e deve essere memorizzato nella cache.
- Sistema a livelli. Le API REST ben progettate sono costruite usando livelli, ognuno con le proprie funzionalità designate. Questi livelli interagiscono, ma rimangono separati. Ciò rende l’API più facile da modificare e aggiornare nel tempo e migliora anche la sua sicurezza.
- Interfaccia uniforme. Tutte le parti di un’API REST devono funzionare tramite la stessa interfaccia e comunicare utilizzando le stesse lingue. Questa interfaccia deve essere progettata specificamente per l’API e in grado di evolvere autonomamente. Non dovrebbe dipendere dal funzionamento del server o del client.
Qualsiasi API che segue questi principi può essere considerata RESTful. Esiste anche un sesto vincolo, denominato “codice su richiesta”. Quando viene seguita, questa tecnica consente all’API di istruire il server a trasmettere il codice a un client, al fine di estenderne le funzionalità. Tuttavia, questo vincolo è facoltativo e non adottato da tutte le API REST.
L’API REST di WordPress
A questo punto, ti starai chiedendo in che modo tutto questo ti riguarda. Le API sono strumenti eccellenti, ma sono rilevanti per il tuo lavoro quotidiano? Se sei un utente di WordPress, la risposta è inequivocabilmente “sì”.
L’API REST di WordPress è in fase di sviluppo da un paio d’anni. Per un certo periodo di tempo è stato utilizzato come plugin indipendente, che gli sviluppatori potrebbero contribuire nel tempo a rendere disponibile a chiunque di sperimentare.
In effetti, c’erano due versioni separate del plugin API REST. Elementi dell’API sono stati aggiunti alla piattaforma principale già nell’aggiornamento 4.4. Questo è stato seguito da esso completamente integrato a partire da WordPress 4.7 (nel 2016). Ciò significa che oggi WordPress ha la propria API REST pienamente funzionante.
Perché la piattaforma ha fatto questa mossa? Secondo il sito del progetto stesso, è perché WordPress si sta evolvendo verso una “struttura applicativa completa”. In altre parole, l’API REST consente alla piattaforma di interagire con qualsiasi sito e applicazione web. Inoltre, può comunicare e scambiare dati indipendentemente dalle lingue utilizzate da un programma esterno.
È inoltre importante notare che potresti sentire questa funzione a volte denominata API REST di WordPress JSON. La parte ‘JSON’, che sta per JavaScript Object Notation, descrive il formato utilizzato da questa API per lo scambio di dati. Questo formato è basato su JavaScript ed è un modo diffuso di sviluppare API grazie alla sua interfaccia con molti linguaggi di programmazione comuni. In altre parole, un’API JSON è in grado di facilitare più facilmente le comunicazioni tra applicazioni che utilizzano lingue diverse.
L’anatomia di una richiesta API REST di WordPress
Ora dovresti capire lo scopo e la direzione generali dell’API REST di WordPress. Pertanto, esaminiamo alcune specifiche su come funziona. Ci sono alcuni concetti di base che devi capire se vuoi essere pratico e iniziare a sperimentare personalmente con l’API.
Come abbiamo spiegato, ogni processo API richiede e restituisce risposte. In altre parole, un client chiede di eseguire una determinata azione e l’API esegue tale azione. Esattamente come le API possono variare. Le API REST sono progettate specificamente per ricevere e rispondere a un particolare tipo di richieste, utilizzando semplici comandi HTML (o “metodi”).
Ecco i metodi HTML basilari e importanti che un cliente può inviare:
- GET: questo comando recupera una risorsa dal server (come una particolare parte di dati).
- POST: Con questo, il client aggiunge una risorsa al server.
- PUT: puoi usarlo per modificare o aggiornare una risorsa già presente sul server.
- DELETE: come suggerisce il nome, rimuove una risorsa dal server.
Insieme a questi comandi, il client invierà una o più righe che comunicano esattamente quale risorsa è desiderata e cosa dovrebbe essere fatto con essa. Ad esempio, una richiesta per caricare un file PHP in una particolare cartella su un server potrebbe essere simile a questa:
POST /foldername/my_file.php
La parte /foldername/my_file.php è chiamata ‘route’, poiché indica all’API dove andare e con quali dati interagire. Quando lo si combina con il metodo HTTP (POST in questo caso), l’intera funzione viene definita “endpoint”.
La maggior parte delle API REST e dei client che interagiscono con esse sono molto più complicate di così: la versione di WordPress inclusa. Tuttavia, questi elementi di base costituiscono la base per il funzionamento dell’API REST di WordPress.
Come iniziare a utilizzare l’API REST di WordPress
Finché hai impostato un sito WordPress, puoi iniziare subito a sperimentare con l’API REST. È possibile eseguire varie richieste GET per recuperare direttamente i dati, semplicemente utilizzando il browser.
Per accedere all’API REST di WordPress, devi iniziare con il seguente percorso:
yoursite.com/wp-json/wp/v2
Quindi, è possibile aggiungere a questo URL per accedere a vari tipi di dati. Ad esempio, puoi cercare un profilo utente specifico tramite un percorso come questo:
yoursite.com/wp-json/wp/v2/users/4567
In questo scenario, “4567” è l’ID utente univoco per il profilo che si desidera vedere. Se hai omesso quell’ID, dovresti invece vedere un elenco di tutti gli utenti sul tuo sito:
Puoi utilizzare lo stesso percorso di base per visualizzare altri tipi di dati, come i tuoi post o le tue pagine. È anche possibile cercare sottoinsiemi di dati che soddisfano determinati criteri. Ad esempio, puoi recuperare tutti i post che includono un termine specifico utilizzando questo URL:
yoursite.com/wp-json/wp/v2/posts?=search[keyword]
Questa è solo una semplice illustrazione, ovviamente. Non c’è quasi limite a ciò che puoi effettivamente fare usando l’API REST di WordPress. Se vuoi saperne di più su come funziona, ti consigliamo di iniziare con le seguenti risorse:
- Il manuale dell’API REST. Questa è una risorsa WordPress ufficiale che documenta tutti i tipi di informazioni sull’API REST. Tra le altre cose, troverai un elenco di endpoint che puoi utilizzare, oltre a dettagli su alcuni aspetti strutturali dell’API REST che non abbiamo toccato qui.
- Esercitazioni su W3Schools. Sebbene questa risorsa non sia specifica dell’API REST, offre esercitazioni pratiche che possono aiutarti a rispolverare concetti chiave, come i metodi HTTP e JSON.
Mentre ci siamo, controlla anche questo elenco dei primi 10 plugin per sviluppatori di WordPress. Saranno sicuramente utili man mano che esplorerai il mondo dell’API REST.
L’API REST di WordPress è senza dubbio un argomento complesso. Anche per i non sviluppatori, tuttavia, vale la pena comprendere le basi su come funziona questa tecnologia e cosa rende possibile. Inoltre, potrebbe persino consentirti di iniziare a dilettarti nello sviluppo da solo!
In conclusione
Non c’è momento migliore per conoscere l’API REST di WordPress di adesso. Dal momento che è stato completamente integrato nel core di WordPress, giocherà un ruolo importante nel futuro della piattaforma. Gli sviluppatori di tutte le strisce useranno questa API per connettere WordPress al Web più ampio in modi che prima erano difficili o impossibili.
Comprendere questo concetto per te può essere un po ‘impegnativo. A un livello base, tuttavia, i concetti sono abbastanza facili da comprendere. Un’API REST è un’interfaccia che consente a due programmi di “comunicare” tra loro e viene creato seguendo le linee guida che garantiscono che sia flessibile, estendibile e sicuro. Se vuoi approfondire il modo in cui tutto questo funziona e come può essere usato, ci sono molte risorse utili là fuori, come il manuale ufficiale.
Avete domande sull’API REST e cosa significa per WordPress? Scrivici nella sezione commenti qui sotto!