Come funziona lAPI? Come integrare lAPI nellapplicazione

L'interfaccia di programmazione dell'applicazione (API) è una delle necessità finali per la creazione di applicazioni intelligenti. È un canale di comunicazione tra due applicazioni. Consapevolmente o meno, ad un certo punto hai utilizzato le API mentre navighi in Internet o utilizzi programmi nella tua vita quotidiana.

Le API spesso inviano dati complessi come risposte, quindi come puoi comprendere e utilizzare queste informazioni per servire i tuoi utenti? Le API semplificano la vita sia agli sviluppatori esperti che a quelli che hanno appena iniziato. Quindi devi sapere come usarli con la tua applicazione.

Con alcuni casi d'uso ed esempi, diamo un'occhiata a come puoi utilizzare le API per servire i tuoi programmi come sviluppatore.

Cos'è l'API?

Le API forniscono un modo per consentire a programmi separati di interagire tra loro

Le API forniscono un modo per consentire a programmi separati di interagire tra loro. Le API definiscono le richieste che possono essere effettuate, come vengono effettuate le richieste e consentono lo scambio di dati tra diverse applicazioni software.

Le API sono di tre tipi: pubbliche, private e partner. Le API pubbliche (o API aperte) sono accessibili pubblicamente a qualsiasi sviluppatore. L'utilizzo delle API pubbliche presenta alcune limitazioni e possono essere gratuite o commerciali. Le API private vengono utilizzate esclusivamente all'interno di un'azienda o organizzazione. Le API partner sono disponibili solo per partner commerciali specifici e vengono utilizzate più frequentemente per facilitare l'integrazione del software tra due aziende diverse.

Come funziona l'API?

Gli sviluppatori creano API come prodotti che possono servire ad altri sviluppatori. L'obiettivo è rendere i processi di sviluppo web complessi più semplici, più efficienti e più veloci per gli sviluppatori consumer o le aziende.

La maggior parte delle aziende ora dipende da API di terze parti per risolvere problemi e servire meglio i propri clienti. Tuttavia, l’utilizzo dell’API non è così complicato come molti pensano. Puoi considerarlo come una soluzione di terze parti, che ti fornisce una risposta specifica sotto forma di dati, quando effettui una specifica richiesta HTTP.

Usare l'API è come ordinare in una pizzeria. Non puoi andare in cucina per dire loro quello che vuoi. Hai bisogno di un cameriere che prenda il tuo ordine e lo consegni in cucina, quindi ritorni con la pizza che desideri.

Puoi pensare a un'API come al collegamento tra te e la cucina. In questo caso sei un cliente che visita un ristorante che fornisce camerieri (API). Il cameriere risponderà quindi con la tua scelta di pizza (dati). In una vera API, l'applicazione web è il client che richiede di consumare il contenuto del provider tramite l'API, effettuando richieste endpoint HTTP.

Come viene utilizzata l'API?

Le API vengono utilizzate in molti casi

Le API vengono utilizzate in molti scenari, incluse categorie come API di database, API remote e API Web. Molto probabilmente interagisci con le API web più volte al giorno mentre navighi sul tuo smartphone o computer. Le API Web scambiano richieste e dati utilizzando il protocollo HTTP.

I siti di prenotazione di viaggi, come Skyscanner e Booking.com, utilizzano API Web per aggregare i dati di volo e destinazione per i clienti. La comodità delle API web permette di verificare in tempo reale la disponibilità delle camere d'albergo e la durata del soggiorno, scambiando istantaneamente richieste e dati dall'hotel.

Cos'è l'endpoint API?

La connessione a un'API richiede il collegamento del programma a un endpoint API. Puoi pensare a questo come a una connessione bidirezionale. L'endpoint connesso al tuo programma invia la richiesta, mentre l'endpoint connesso all'API ti restituisce una risposta specifica.

Un endpoint è un URL di richiesta e fornisce al client l'accesso diretto alle risorse di un'API.

Oltre a recuperare i dati utilizzando l'API, puoi anche POST richieste dal provider al client, utilizzare il metodo PUT per ottenere maggiori informazioni dal provider, nonché utilizzare il metodo DELETE per eliminare i dati esistenti dal tuo programma. Ciascuno di questi metodi è generalmente disponibile nella documentazione dell'API.

Criteri per la connessione all'API

Integrare un'API con il tuo programma non è solo una decisione spontanea, è premeditata. Devi conoscere le informazioni e la quantità che desideri. Ciò aiuta a ridurre la complessità, soprattutto se si elaborano dati JSON come array multidimensionale. Ti consente inoltre di ottenere le informazioni specifiche di cui hai bisogno per il tuo programma.

Esistono centinaia di API disponibili con regole diverse per la connessione. Mentre alcune API sono gratuite e open source, altre sono accessibili solo su abbonamento.

Mentre alcune API sono semplici e senza interruzioni e non richiedono alcun prerequisito, altre API potrebbero richiedere il rispetto di condizioni come la generazione di una chiave API o la registrazione di un account sviluppatore prima di potersi connettere all'endpoint.

Tuttavia, uno degli aspetti più importanti di qualsiasi API è la sua documentazione. È meglio leggere e seguire la documentazione di qualsiasi API a cui prevedi di connetterti per istruzioni su come codificare e utilizzare le sue risorse. Questo perché ogni API ha i propri metodi e istruzioni di connessione.

Per connettersi a qualsiasi API è necessario conoscere anche i linguaggi di programmazione che supporta.

Come connettersi ad un'API: Esempio pratico

Non esiste un modo specifico per connettersi all'API, ma alcuni esempi ti mostreranno le nozioni di base su come utilizzare i dati API con la tua applicazione.

Diamo un'occhiata ad un breve codice di esempio su come connetterti a un'API.

Come utilizzare l'API Color Picker di Iro.Js

Iro.js è una semplice API che ti consente di aggiungere un selettore di colori gratuito al tuo sito web. Quando selezioni un punto sulla ruota dei colori, l'API restituisce il codice esadecimale o RGB di quel colore. Per connetterti all'API iro.js, tutto ciò che devi fare è incollare il suo endpoint CDN (Content Delivery Network) all'inizio del DOM.

La documentazione completa di questa API è disponibile su iro.js.org:

https://iro.js.org/guide.html

Vediamo come connetterti a questa API con il codice di esempio riportato di seguito:

Display color picker

Nel caso dell'API di esempio sopra, non è necessaria una chiave API per connettersi ad essa. Tuttavia, per capire meglio, diamo uno sguardo più da vicino a JavaScript. Per connettersi a questa API, è sufficiente chiamare la funzione ColorPicker dalla classe iro , quindi passare l'id del contenitore della ruota dei colori alla classe.

È facile connettersi all'endpoint API iro.js, poiché i suoi sviluppatori hanno svolto il lavoro extra di codificare il livello per gli utenti. L'immagine seguente è il risultato del codice di esempio sopra.

Risultato del codice di esempio

Per vedere come avviene l'evento di cambio colore, puoi aprire un altro file HTML e incollare il seguente codice nella sua sezione degli script :

var colorPicker = new iro.ColorPicker('#color-pick', {
   // Set the size of the color picker
   width: 400,
   // Set the initial color to pure red
   color:"#ff0000"
 });
const myColor =(color)=>{
	console.log(color.hexString);
};
colorPicker.on("color:change", myColor);

Il codice sopra registra valori di colore esadecimali ogni volta che cambi la posizione del selettore di colori sulla ruota.

Come utilizzare l'API di cambio valuta NoCodeAPI

NoCodeAPI fornisce molte API, inclusa l'API di conversione della valuta. Per connetterti a questo endpoint di cambio valuta, visita NoCodeAPI e crea un account:

https://app.nocodeapi.com/login

Quando accedi, c'è una barra di ricerca nella parte superiore della pagina. Nella barra di ricerca, digita cambio valuta , quando viene visualizzata la query fai clic su Attiva.

Nella pagina successiva, fai clic su Crea API per il cambio valuta . Successivamente, inserisci un nome per l'API e fai clic su Crea.

Una volta creata l'API, fai clic su Visualizza documentazione. Successivamente, seleziona la tua lingua preferita per visualizzare il codice che si connette all'endpoint API. Puoi quindi copiare il codice di esempio e incollarlo nella tua app per un'ulteriore personalizzazione.

Vedi il codice di esempio qui sotto per la conversione della valuta: