Anche se non sai cos'è un'API, ne hai indubbiamente interagito.
Oggi, consideriamo la connettività tra tecnologia ampiamente scontata. Ad esempio, non ci interroghiamo quando usiamo OpenTable per effettuare una prenotazione in un ristorante vicino.
In alternativa, se usi Kayak.com per prenotare voli, probabilmente non ti sei mai chiesto, Aspetta un attimo … come fa Kayak a sapere che JetBlue ha un posto libero in 27A?
In definitiva, ogni volta che è necessario che le applicazioni comunichino tra loro, è necessaria una API o un'interfaccia di programmazione dell'applicazione.
Qui, esploreremo cos'è un'API e perché dovresti usarne uno. Anche se non sei un programmatore e non farlo bisogno per conoscere un ampio gergo tecnico, dovresti ancora capire le basi, poiché al giorno d'oggi le integrazioni tra la tecnologia sono spesso componenti critiche del lavoro di chiunque.
Cos'è un'API?
Nella sua definizione più elementare, un'API consente a un singolo software di parlare con un altro software.
Per comprendere una API in azione, consideriamo un esempio di vita reale: l'integrazione di HubSpot con Typeform. Typeform, uno strumento che fornisce quiz predisposti per dispositivi mobili, moduli di contatto e moduli di iscrizione, deve integrarsi con l'API Form di HubSpot per interagire con lo strumento Moduli e inviare invii in modo semplice dai moduli Typeform a HubSpot CRM.
Per fare ciò, l'API di Typeform e l'API di HubSpot devono parlare. Un'integrazione può fungere da traduttore, assicurando che ogni informazione dell'API sia tradotta correttamente per l'altra applicazione – in questo caso, l'integrazione può garantire che i campi del modulo Typeform siano mappati correttamente ai campi HubSpot corrispondenti.
Isaac Takushi, uno specialista del supporto per gli sviluppatori HubSpot, spiega: "Si può pensare alle API e agli endpoint che costituiscono punti di accesso per informazioni diverse.Ogni endpoint dell'API può avere solo un lavoro specifico. Se combinati, tuttavia, diversi endpoint possono supporta integrazioni potenti e sfaccettate. "
Kayak.com, ad esempio, ha bisogno di alcune API per comunicare con i sistemi di JetBlue. Quando cerchi "Boston a Charlotte" in Kayak, l'API di prenotazione di JetBlue riceverà essenzialmente questa richiesta da Kayak, recupererà le informazioni relative a tale richiesta e la rimanderà indietro. Tuttavia, Kayak avrà bisogno del suo proprio API o codice per comprendere e agire sulle informazioni restituite dall'API JetBlue.
Come usare un'API
Per utilizzare un'API, spesso hai bisogno della chiave API, poiché la maggior parte delle API lo richiede. Dai un'occhiata alla documentazione delle API per i requisiti di accesso. Quindi, trova online un client HTTP, come Postman o Runscope. Questi strumenti ti aiuteranno ad accedere all'API con la tua chiave API con pochissima codifica richiesta.
Per utilizzare un'API, ti consigliamo di consultare la documentazione dell'API per i requisiti di accesso. Ad esempio, l'API Contatti di HubSpot richiede l'autenticazione:
Allo stesso modo, avrai bisogno di una chiave API per accedere all'API di Google, all'API di Facebook e API di Twitter.
Una volta soddisfatti i requisiti di accesso, è possibile utilizzare uno strumento come Postman o Runscope per interagire manualmente con un'API. Questi strumenti di terze parti, o "client REST", consentono di effettuare richieste una tantum agli endpoint API senza codifica. Sono ottimi per dare un'idea di ciò che i tuoi sistemi di back-end possono fare automaticamente. Dai un'occhiata a questa risorsa su come realizzare la tua primissima richiesta API con Postman.
Se non sei ancora pronto per entrare nel deep end con un client REST, prova a inserire il seguente comando nel browser:
https://restcountries.eu/rest/v2/name/united
Questo è un endpoint API pubblico dal servizio REST Countries gratuito. Nello specifico, utilizziamo l'endpoint "Nome", che accetta nomi di paesi come query di ricerca. Una ricerca riuscita restituirà le potenziali corrispondenze nazionali, insieme a informazioni chiave su ogni nazione. In questo caso, stiamo cercando paesi con nomi che contengono la parola "uniti".
Dovresti vedere il seguente blocco di dati JSON restituito:
Congratulazioni! Hai appena fatto una richiesta API dal tuo browser!
L'endpoint ha restituito dati non elaborati (formattati in JSON) sui paesi con "uniti" nel nome.
Potrebbe non sembrare carino, ma ricorda che le API sono progettate per applicazioni che non richiedono lo stile che gli umani si aspettano da una pagina Web HTML. Mentre puoi facilmente "paesi che iniziano con Google" uniti ", le applicazioni non possono. Potrebbero dover contare su servizi come i Paesi REST per cercare quelle informazioni.
Se non sei sicuro se dovresti utilizzare i tuoi sviluppatori interni per creare API o guardare esternamente, controlla le API First vs. Third-Party: Che cosa devi sapere.
Originariamente pubblicato il 17 maggio 2019 alle 7:00:00, aggiornato il 17 maggio 2019
Non dimenticare di condividere questo post!