Che cos'è un'API?

Se lavori con la tecnologia da un po' di tempo, probabilmente ti sei imbattuto nel termine API. Per coloro che hanno programmato e capiscono come creare un sito Web da zero, conoscerai molto bene il termine API.

Un'API è alla base di molte delle funzioni popolari che utilizzi sui siti Web. È un acronimo che sta per Application Programming Interface. Un buon esempio potrebbe essere pensare a una ricetta per preparare diversi tipi di cibo. Ogni ricetta ha istruzioni passo passo su come creare il piatto. Questo è il codice coinvolto con l'API. Un computer deve seguire una serie di istruzioni per eseguire un'attività.

Puoi prendere quella ricetta e darla a qualsiasi chef. Saranno in grado di interpretare gli ingredienti e capire come combinare tutti i diversi elementi nel prodotto finito. Hai anche la possibilità di seguire tu stesso le indicazioni per mettere insieme la ricetta se capisci la cucina e hai abbastanza formazione per usare tutti gli strumenti in cucina. Un'API, alla fine, è solo una ricetta che il computer sa come seguire.

Sviluppatori e API

Continuando con la nostra illustrazione di come funziona un'API, alcuni porteranno la ricetta a uno chef professionista che può mettere insieme rapidamente il cibo e darti qualsiasi piatto tu ordini. Uno sviluppatore è come una persona che può già creare la ricetta e modificarla.

Un'API è una serie di istruzioni al computer. Per uno sviluppatore con esperienza di programmazione, può modificare alcuni aspetti dell'API e modificarla per soddisfare le proprie esigenze. Questo andrà oltre lo scopo di molti che vogliono semplicemente collegare l'API al proprio sito.

L'utilizzo di un'API è utile per gli utenti di tutti i giorni perché consente loro di ottenere più funzionalità dal proprio sito Web senza creare il codice da soli. Forse vorresti visualizzare il tempo e l'ora per un utente che sta visitando il tuo sito web. Questo contenuto è dinamico e non statico. Non puoi semplicemente mettere giù il tempo per un giorno e lasciarlo. Il valore è in continua evoluzione, quindi è necessario accedere a un'API in modo che le informazioni vengano aggiornate.

API e WordPress

Se stai utilizzando WordPress e stai cercando un modo per integrare un'API, ti consigliamo di farlo tramite un plugin o un tema WordPress. Molti plugin gratuiti e premium possono aiutarti a integrare le API abbastanza facilmente. Tuttavia, la maggior parte di essi è molto limitata a meno che tu non paghi.

Se sei tu stesso a conoscenza della programmazione, è semplice integrare un'API esterna sul tuo sito WordPress. Per questo consigliamo questa guida di Rapidapi che spiega come integrare API esterne.

Contenuto dinamico

Ogni volta che hai a che fare con contenuti dinamici, il tuo primo pensiero dovrebbe essere quello di trovare un'API in grado di fornire informazioni in rapida evoluzione al tuo sito web. Può anche farti interagire con programmi popolari a un livello più profondo.

Prendi, ad esempio, Twitter. Questa è una piattaforma popolare per le persone interessate ai social media. Se fai parte del marketing digitale, vorrai accedere alle cose a un livello più profondo. Utilizzando l'API di Twitter, puoi estrarre rapidamente le informazioni nei fogli di calcolo per scomporle e capire cose come gli interessi degli utenti e quante connessioni hanno. Se sei un marketer digitale, vorrai identificare rapidamente le persone in determinati dati demografici in modo da sapere quali prodotti proporre loro. L'API di Twitter ti consente di fare queste cose perché puoi estrarre enormi quantità di informazioni tutte in una volta invece di compilare tutto a mano.

Migliorare il tuo sito

Abbiamo esaminato brevemente come puoi migliorare la tua attività utilizzando un'API per una grande azienda. Cos'altro possiamo estrarre da siti Web esterni? Oltre a caricare il meteo per un utente che cambia dinamicamente, possiamo visualizzare qualcosa di un po' più interessante.

Ti piacerebbe un sito Web in grado di visualizzare le ultime immagini di Flickr o persino di Facebook? Questo sarebbe un ottimo contenuto per i tuoi utenti a cui saranno interessati. Per questo, prima individua la documentazione API per Flickr. È importante affrontarlo prima se riscontri problemi con l'integrazione dell'API nel tuo sito.

Ora vedrai la possibilità di richiedere il formato che desideri. Per molte API, avrai scelte come REST, XML-RPC e SOAP. In questo caso, scegli REST, che è molto popolare con i siti WordPress. Quando fai clic su questo, ti verrà presentato un endpoint API REST di Flickr.

Cos'è il RIPOSO?

REST è un altro acronimo da imparare se vuoi avere contenuti dinamici e in continua evoluzione sul tuo sito. Con REST, possiamo quindi utilizzare GET, POST e DELETE. Questo è per tutti i dati su Flickr, ma funziona anche per Facebook, Google o Instagram.

L'acronimo sta per Representational State Transfer. È stato creato per distribuire l'ipermedia e per la prima volta ha colpito la scena con Roy Fielding nel 2000. Ora puoi avere richieste HTTP che otterranno dati per te. Le richieste HTTP possono anche inviare dati ad altri siti Web. L'API è il linguaggio che parlano due programmi per computer mentre parlano tra loro e comunicano. Comprendendo questo linguaggio e come funziona, puoi estrarre dati da quasi tutti i siti.

Chiavi API

I siti Web non semplificheranno l'acquisizione di dati da visualizzare sul tuo sito WordPress. Devi prima creare un account. Una volta che hai il tuo account con il sito web, richiedi una chiave API da loro. Assicurati di leggere i termini di servizio. Ci sono termini specifici che saranno diversi a seconda del sito web con cui stai lavorando. Alcuni siti limiteranno il numero di richieste HTTP GET che puoi effettuare durante un determinato periodo di tempo.

Forse sei limitato a sole 50 richieste GET per un determinato giorno. Ciò assicura che i server non vengano costantemente martellati da persone che cercano di fare richieste sulle risorse. Puoi aumentare i limiti come questi molte volte scegliendo una versione Pro o una versione commerciale. Quando esegui l'aggiornamento, avrai accesso a più richieste HTTP che utilizzi per chiamare i server. Questo verrà solitamente utilizzato da un'azienda che deve effettuare molte chiamate e non si applicherebbe a un utente normale che sta solo cercando di visualizzare nuove informazioni sul proprio sito.

Richiedi l'autorizzazione

Non sarai sempre in grado di ottenere l'autorizzazione per avere una chiave API. Alcuni siti richiedono l'applicazione e la spiegazione del motivo per cui si desidera accedere alla chiave. Le aziende non vogliono un carico enorme sulle proprie risorse a meno che lo sviluppatore non utilizzi attivamente le chiamate per promuovere i propri prodotti e servizi. Potrebbero anche avere un team che esamini la tua richiesta. Se vuoi familiarizzare con la tecnologia, richiedi l'accesso da un sito Flickr in cui i requisiti sono bassi. Ora avrai la tua chiave e il codice insieme ad essa.

Autenticazione e API

Quindi, considera se desideri utilizzare l'API per ottenere dati che richiedono l'autenticazione. Ad esempio, se dovessi utilizzare un'API di Facebook o Instagram che ti dà la possibilità di pubblicare immagini e testo, questo dovrebbe essere autenticato. Perchè è questo? Bene, se la pensi in questo modo, dovresti avere un account per pubblicare normalmente su Facebook. Non è possibile pubblicare in modo anonimo sul sito. Allo stesso modo, se un'API sta pubblicando per tuo conto, devi anche essere autenticato con un nome utente e una password per entrare. Questo ti identificherà e il contenuto pubblicato ti ricollegherà se vengono pubblicate cose che non dovrebbero esserlo.

Molti sistemi utilizzeranno OAuth per l'autenticazione poiché il protocollo è facile da usare e offre agli utenti un modo semplice per far interagire l'API con un sito Web come proxy. Le informazioni vengono inviate tramite un collegamento sicuro in modo che l'identità dell'utente non venga rivelata. Tuttavia, non è sempre necessario essere autenticati.

Mettere tutto insieme

Ora abbiamo tutti i pezzi di cui abbiamo bisogno per iniziare a fare chiamate API. In WordPress, accedi ad Aspetto e poi a Widget. Questi sono scritti in PHP. Utilizzando la documentazione dell'API che hai estratto dal sito Web, incollala per iniziare a fare richieste. Nel caso di utilizzo dell'API Flickr, l'URL sarà simile a https://flickr.com/services/rest

Nel codice, se vedi una riga per la tua chiave API, copiala da quando l'hai richiesta e hai ricevuto la password e la chiave. Quando si recuperano i dati da un sito, potrebbero essere in formato HTML, XML, testo o JSON. Supponiamo che tu non abbia completamente familiarità con tutti questi formati; questo va bene. Selezionane uno con cui sarai in grado di lavorare e che sarai in grado di interpretare in seguito.

Guardando i dati

Una volta che hai finito di incollare le informazioni necessarie per ottenere i dati, avrai anche bisogno di un file PHP o di un file WordPress per leggere i dati e visualizzare le informazioni sullo schermo. Ancora una volta, torna alla documentazione API sul sito per l'azienda con cui stai lavorando. Dovrebbe esserci un blocco di codice che genererà i dati in un formato che puoi leggere come testo o visualizzare come immagini sul tuo sito WordPress.

Formattazione dei dati

Una volta che vedi che i dati vengono visualizzati sul tuo sito, potrebbe sembrare strano. La formattazione è solo il flusso di dati grezzi. Quando si effettua una chiamata API a un sito esterno, non c'è alcun tentativo di formattarlo in un modo che sembrerà piacevole. Se vuoi modellare i dati in modo che appaiano presentabili, puoi utilizzare un file CSS che è diretto a rifinire tutto. Se hai problemi a scrivere il CSS, puoi trovare degli esempi online per darti qualche dritta. Copia il codice nel tuo file CSS in modo che il tuo sito WordPress possa accedervi.

Conclusione

Questo è stato un breve tutorial su come integrare un'API con il tuo sito WordPress. L'argomento è complesso e può essere difficile anche quando si copia il codice. Se riscontri problemi, fai il check-in con alcuni siti online e ricordati di tornare su Temi superbi per ulteriori recensioni e tutorial.