API REST di WordPress: cos’è e come iniziare ad usarlo

Se hai trascorso un po ‘di tempo nella community di WordPress negli ultimi anni, è probabile che tu abbia sentito il riferimento fatto alla nuova API REST. Tuttavia, a meno che tu non sia uno sviluppatore esperto, potresti non avere idea di cosa sia effettivamente l’API REST di WordPress.


Mentre i dettagli tecnici sono un po ‘complessi, i concetti di base alla base di questa funzione sono abbastanza facili da comprendere. La nuova API aiuta a espandere ciò che WordPress come piattaforma può fare. Inoltre, l’API REST rende più semplice che mai per gli sviluppatori la connessione di WordPress con altri siti e applicazioni.

API REST di WordPress

In questa guida completa, ti guideremo attraverso tutte le nozioni di base che devi conoscere. Spiegheremo quali API sono in generale e quali API REST (e la versione specifica di WordPress) sono in particolare. Quindi, parleremo di come iniziare a utilizzare l’API REST di WordPress da soli. Facciamo un salto!

Un’introduzione alle API (Application Programming Interface)

Prima di approfondire in modo specifico l’API REST, eseguiamo un po ‘di backup. Per comprendere questo concetto, è fondamentale innanzitutto avere un’idea di base delle API in generale.

Al suo livello più fondamentale, un’API – o interfaccia di programmazione dell’applicazione – consente a due applicazioni di comunicare tra loro. Ad esempio, quando visiti un sito Web, il tuo browser invia una richiesta al server in cui si trova quel 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ù da fare il modo in cui funzionano le API in senso tecnico, ovviamente. 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 impacchettarle e fornirle come prodotti che è possibile utilizzare.

In altre parole, gli sviluppatori di un’azienda come Google raccoglieranno insieme alcune parti del codice della loro applicazione e renderlo disponibile al pubblico. 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à:

Biblioteca di API di Google.

Ad esempio, puoi utilizzare l’API di Google Maps per posizionare una mappa perfettamente funzionante sul tuo sito che beneficia di tutti i dati e le funzioni pertinenti di Google. Questo ti evita di dover codificare una mappa e raccogliere tu stesso tutti quei dati. Lo stesso vale per un’ampia gamma di siti e applicazioni.

Man mano che i siti Web e le funzionalità su cui fanno affidamento diventano più complessi, strumenti come le API diventano cruciali. Consentono 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 della maggiore esposizione e traffico.

Le regole fondamentali di un’API REST (Representational State Transfer)

Esistono molti modi per creare un’API. UN API REST (Representational State Transfer) è un tipo particolare sviluppato secondo 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, devi quindi sapere a quali regole (o “vincoli”) funzionano. Ci sono cinque elementi di base che rende 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 collega a tale piattaforma:

Riposante

  1. Architettura client-server. L’API deve 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 utilizzati indipendentemente.
  2. apolidia. Le API REST devono seguire un protocollo “senza stato”. In altre parole, non possono archiviare 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.
  3. Cache. Una “cache” è l’archiviazione temporanea di dati specifici, quindi può essere recuperato e inviato più velocemente. Le API RESTful utilizzano i dati memorizzabili nella cache ogni volta che è possibile, per migliorare la velocità e l’efficienza. Inoltre, l’API deve comunicare al client se ogni dato può e deve essere memorizzato nella cache.
  4. Sistema a strati. Le API REST ben progettate sono costruite usando i livelli, ognuno con la propria funzionalità designata. Questi livelli interagiscono, ma rimangono separati. Ciò rende l’API più semplice da modificare e aggiornare nel tempo e anche migliora la sua sicurezza.
  5. Interfaccia uniforme. Tutte le parti di un’API REST devono funzionare tramite la stessa interfaccia e comunicare utilizzando le stesse lingue. Questa interfaccia dovrebbe essere progettata specificamente per l’API e in grado di evolversi da sola. Non dovrebbe dipendere dal server o dal client per funzionare.

Qualsiasi API che segue questi principi può essere considerata RESTful. Esiste anche un sesto vincolo, denominato “codice su richiesta”. Se seguita, questa tecnica consente all’API di istruire il server a trasmettere 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 come tutto ciò ti influenza. Le API sono strumenti eccellenti, ma sono rilevanti per il tuo lavoro quotidiano? Se sei un utente WordPress, la risposta è inequivocabile "sì".

L’API REST di WordPress è in fase di sviluppo da un paio d’anni. Per un bel po ‘, è stato lavorato su come un plugin indipendente, a cui gli sviluppatori potevano contribuire nel tempo era disponibile per chiunque a sperimentare.

In effetti, c’erano due versioni separate del plug-in API REST. Alcuni elementi dell’API sono stati aggiunti alla piattaforma principale già dall’aggiornamento 4.4. Questo è stato seguito dalla sua piena integrazione a partire da WordPress 4.7 (nel 2016). Ciò significa che oggi WordPress ha la sua API REST completamente funzionale.

Perché la piattaforma ha fatto questa mossa? Secondo il sito del progetto stesso, è perché WordPress si sta muovendo verso diventare un "quadro applicativo completo". 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.

resto api

Questo apre numerose possibilità per gli sviluppatori. Inoltre, rende WordPress una piattaforma più flessibile e universale che mai. Nel ruolo di Katie Keith, direttore delle operazioni presso Barn2 Media lo mette:

Comprendendo l’API REST, gli sviluppatori di WordPress possono scegliere il modo più efficace per implementare ogni attività, senza essere limitati a tecnologie o piattaforme specifiche come PHP o il back-end di WordPress. Utilizzata in modo efficace, l’API REST semplifica notevolmente le integrazioni di terze parti … Apre anche nuove opportunità, ad esempio per creare le tue app mobili basate su WordPress o esplorare modi nuovi e unici per comunicare con WordPress.

È anche importante notare che potresti sentire questa funzione a volte denominata API REST JSON di WordPress. La parte “JSON”, che sta per JavaScript Notation Object, descrive il formato utilizzato da questa API per scambiare dati. Tale formato si basa su JavaScript ed è un modo popolare 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 generale e la direzione dell’API REST di WordPress. Pertanto, entriamo in alcuni dettagli su come funziona. Ci sono alcuni concetti di base che devi capire se vuoi metterti in pratica e iniziare a sperimentare tu stesso l’API.

Come abbiamo spiegato, ogni API elabora richieste e restituisce risposte. In altre parole, un client gli chiede di eseguire una determinata azione e l’API esegue tale azione. Il modo esatto in cui le API fanno ciò può variare. Le API REST sono progettate specificamente per ricevere e rispondere a particolari tipi di richieste, utilizzando semplici comandi HTML (o “metodi”).

Per illustrare, ecco i più metodi HTML di base e importanti un cliente può inviare:

Metodi HTML

  • OTTENERE: Questo comando recupera una risorsa dal server (come un particolare dato).
  • INVIARE: Con questo, il client aggiunge una risorsa al server.
  • METTERE: Puoi utilizzarlo per modificare o aggiornare una risorsa che è già sul server.
  • ELIMINA: Come suggerisce il nome, questo 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 cartella specifica su un server potrebbe apparire così:

POST / nomecartella/mio_file.php

La parte /foldername/my_file.php è chiamato il “percorso”, 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 i client che interagiscono con esse diventano molto più complicati di questo – inclusa la versione di WordPress. 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 l’API REST. È possibile eseguire varie richieste GET per recuperare i dati direttamente, semplicemente utilizzando il browser.

Per accedere all’API REST di WordPress, dovrai iniziare con il seguente percorso:

yoursite.com/wp-json/wp/v2

Quindi, puoi aggiungere 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 lasciassi quell’ID, vedresti invece un elenco di tutti gli utenti sul tuo sito:

Un elenco di utenti nell'API REST di WordPress.

Puoi utilizzare lo stesso percorso di base per visualizzare altri tipi di dati, come post o pagine. È anche possibile cercare sottoinsiemi di dati che soddisfano determinati criteri. Ad esempio, è possibile 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 utilizzando l’API REST di WordPress. Se vuoi saperne di più su come funziona, ti consigliamo di iniziare con le seguenti risorse:

L’API REST di WordPress è senza dubbio un argomento complesso. Anche per i non sviluppatori, tuttavia, vale la pena comprendere le basi di come funziona questa tecnologia e cosa rende possibile. Inoltre, potrebbe anche permetterti di iniziare a dilettarti nello sviluppo da solo!

Un altro approccio all’utilizzo dell’API REST di WordPress

L’API REST di WordPress può essere utilizzata per una serie di cose e progetti interessanti. Lo abbiamo stabilito abbastanza chiaramente.

C’è un settore, tuttavia, in cui sta riscuotendo un certo successo:

WordPress senza testa è l’idea di disaccoppiare i due livelli principali dell’ecosistema WordPress: il backend e il frontend.

Ciò ti consente di prendere tutte le chicche che il software WordPress ha sotto il cofano e collegarle a un prodotto finale che non utilizza la presentazione WordPress standard – non è un sito Web, di per sé.

L’intero concetto è molto interessante. Ne parliamo un po ‘di più in un altro post, in cui discutiamo se WordPress senza testa ha senso e confrontiamo le migliori soluzioni di hosting WordPress senza testa sul mercato.

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 alla rete più ampia in modi precedentemente difficili o impossibili.

Comprendere questo concetto per te stesso può essere un po ‘impegnativo. A livello di base, tuttavia, i concetti sono abbastanza facili da comprendere. Un’API REST è un’interfaccia che consente a due programmi di “dialogare” tra loro e viene creata seguenti linee guida che garantiscono che sia flessibile, estensibile e sicuro. Se vuoi approfondire il modo in cui tutto questo funziona e come può essere utilizzato, ci sono molte risorse utili là fuori, come il funzionario manuale.

Hai domande sull’API REST e cosa significa per WordPress? Chiedici nella sezione commenti qui sotto!

Non dimenticare di partecipare al nostro corso intensivo per accelerare il tuo sito WordPress. Con alcune semplici correzioni, puoi ridurre i tempi di caricamento anche del 50-80%:

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map