Che cos'è un'API? [Lettura rapida]

Se non sei uno sviluppatore, ma lavori nel settore tecnologico, il termine API è probabilmente qualcosa che capisci in senso colloquiale. Probabilmente sai cosa significa (interfaccia di programmazione dell'applicazione) e forse i tuoi team usano le API per fare il loro lavoro, o forse è anche il prodotto stesso (Twilio SendGrid, per esempio).

Ma cos'è esattamente un'API e come funzionano?

Comprendere i principi più profondi alla base delle API ti aiuterà a commercializzare, vendere o utilizzare meglio queste tecnologie da solo.

Questo post spiega come funzionano le API, come gli sviluppatori le creano e come usarle (con esempi del mondo reale).

Come funzionano le API?

Il modo in cui i browser Web interagiscono con i server è un principio fondamentale delle API. Il web è una raccolta di server remoti sparsi in tutto il pianeta. Quando si apre un browser e si digita un sito Web, il browser effettua una chiamata al server del client (qualunque applicazione o server su cui è ospitato un sito Web) per recuperare e visualizzare qualsiasi cosa risieda su quell'URL.

Sebbene un'API non sia il server stesso, è la parte del server, nota come endpoint, che invia e riceve determinate risposte. Le API sono un modo per diverse parti di software di comunicare (ovvero invio e ricezione) tra loro aprendo gli endpoint.

Gli sviluppatori impostano le chiamate API per recuperare dati specifici necessari per vari scopi durante la creazione di applicazioni o siti Web. Per esempio:

• Hai appena aperto la tua app Instagram? Ciò è stato reso possibile da una chiamata API.
• Hai mai aggiunto un evento al tuo Google Calendar da un altro sito web o email? Quel sito stava sfruttando l'API di Google Calendar per acquisire quelle informazioni specifiche dal server di Google Calendar.

Takeaway: gli sviluppatori impostano le chiamate API per recuperare tipi di dati specifici per visualizzare ciò di cui hanno bisogno quando un utente si trova su un sito Web o esegue un'applicazione.

L'ascesa del RIPOSO

Un altro termine che probabilmente hai sentito è API REST. Non è diverso per dire dalla definizione tradizionale di un'API. Tuttavia, vale la pena capire perché le API REST sono diventate così popolari e cosa distingue le API REST dalle altre.

All'inizio, le API venivano create per soddisfare i requisiti di SOAP (Simple Object Access Protocol). Ma questo metodo era un po' noioso e richiedeva molta larghezza di banda per trasferire i set di dati. Richiedeva anche molta energia da parte degli sviluppatori (come non il tipo divertente). SOAP utilizza il noto linguaggio di markup XML per visualizzare i dati. Utile per garantire la compatibilità universale, ma questo è tutto.

Gli sviluppatori erano alla ricerca di modi più leggeri e flessibili per effettuare chiamate API. Le API REST (trasferimento dello stato rappresentativo) forniscono una soluzione alternativa all'API SOAP. Non sono vincolati da un protocollo specifico, anche se devono soddisfare determinati stili architettonici (se sei interessato ad approfondire, vai qui).

Invece di essere visualizzato con markup XML, il server utilizza invece il linguaggio JSON leggero (solo file di testo). Le API REST sono molto più leggere in termini di larghezza di banda rispetto a SOAP (in genere sono solo un URL) e sono naturalmente ottimizzate per la comunicazione sul Web.

Takeaway: pensa alle API REST come alla Marie Kondo dei dati. Prendono e usano solo *precisamente* ciò di cui hanno bisogno. Le API SOAP sono come il garage del tuo vicino che è attualmente pieno fino all'orlo di carta igienica.

Comprendere diversi tipi di API

Indipendentemente dal protocollo o dagli stili seguiti da un'API, esistono diversi tipi di API, tra cui:

• API aperte : note anche come API pubbliche, questi endpoint sono accessibili da qualsiasi sviluppatore e in genere non impongono alcuna restrizione all'utente. In genere accettano donazioni.
• API dei partner : si tratta di API progettate per essere utilizzate insieme e in genere sono accessibili solo da una sorta di mercato.
• API interne : si tratta di strumenti interni che le aziende utilizzano per aiutare i propri dipendenti a essere più efficienti o fornire un modo più sicuro per condividere dati/informazioni.
• API composite : le API composite sono un modo per consolidare le chiamate API correlate ma normalmente richiederebbero chiamate API individuali.

Esempi reali di API

Ci sono un sacco di API in circolazione (alcune contano fino a 15.000) che aiutano gli utenti ad accedere a diverse applicazioni. Di seguito sono riportati alcuni elementi importanti che ti aiuteranno a comprendere l'ambito dell'ecosistema API.

Il Cocktail DB

Diciamo che possiedi un negozio di liquori locale e desideri fornire ricette di cocktail sul tuo sito web. Potresti prendere in considerazione l'utilizzo dell'API Cocktail DB sopra. Tutti quei dati (le ricette dei cocktail) esistono già sul server di qualcun altro e possono essere valutati tramite l'API.

Quando un utente fa clic sulle ricette di margarita (probabilmente il cocktail superiore), i loro server scoprono che la ricetta specifica la invia in JSON, viene prelevata dal sito Web e analizzata in HTML e CSS per essere presentabile sul browser del tuo sito Web.

Apri Mappa Meteo

L'aggiunta di una sezione meteo al tuo sito Web è un caso d'uso super comune. Pensa a qualsiasi stazione sciistica, negozi di biciclette o società di tour. L'API di OpenWeatherMap memorizza tutte le previsioni e le informazioni meteorologiche e visualizza solo la parte richiesta.

Questa API fornisce versioni gratuite e premium a seconda della quantità di dati che desideri visualizzare.

API di posta elettronica SendGrid

L'API SendGrid Email sfrutta l'SMTP (Simple Mail Transfer Protocol) per consentire ai clienti di inviare grandi quantità di e-mail transazionali e attivate: pensa alla reimpostazione della password, alla conferma dell'account e alle notifiche di spedizione.

Twilio SMS

L'API Twilio SMS è un'altra API REST che fornisce un modo per aggiungere funzionalità di messaggistica alle applicazioni. La messaggistica SMS è diventata sempre più popolare come un modo per i marchi di comunicare con i clienti perché è personale, in tempo reale e questi messaggi vengono letti a tassi molto più elevati.

Come utilizzare un'API

Prima che tu o il tuo team iniziate a utilizzare le API, è importante sapere se sono aperte, utilizzate insieme a un servizio partner o composte.

Come iniziare con un'API

Leggi la documentazione. Qualsiasi API dovrebbe avere la documentazione applicabile da seguire. Ti dirà quali dipendenze hai, che tipo di API è e come usarla. La scarsa documentazione dovrebbe essere una bandiera rossa per te e il tuo sviluppatore. Siamo piuttosto orgogliosi della superba documentazione di Twilio e SendGrid.

Genera una chiave API. Dovrai generare una chiave API per iniziare a usarla. Ecco le istruzioni dell'API di Google Maps:

Nota : non condividere mai le chiavi API e assicurati che non siano visibili su alcun codice pubblico inserito su GitHub.

Inizia a creare: invia e-mail gratuitamente con l'API SendGrid Email

Il resto sta a voi! Le opportunità sono davvero infinite quando lavori con le API. Per dare un'occhiata a tutte le opportunità di lavorare con l'API Twilio, dai un'occhiata a Twilio Code Exchange.

Se sei interessato a utilizzare l'API SendGrid Email per inviare e-mail gratuite, dai un'occhiata qui.