Cos'è un'API? La risposta in 300 parole o meno

Quando l'industria del marketing si è spostata per la prima volta dal marketing inbound a quello inbound, molti marketer hanno abbandonato i loro vecchi ruoli di content interrupt per i nuovi creatori di contenuti.

Ma quel turno sta ancora producendo scosse di assestamento e per stare al passo con i tuoi concorrenti oggi, devi capire cosa API sono, come si integrano con la tua strategia di contenuti e le informazioni social che portano sul tuo sito web.

Non preoccuparti: le API potrebbero sembrare complicate, ma alla fine di questo post, saprai come funzionano e cosa comporta il loro utilizzo. Ecco una breve definizione di un'API, seguita da alcune informazioni chiave su come realizzare un lavoro per la tua azienda.

Cos'è un'API?

Un'API, abbreviazione di interfaccia di programmazione automatica, è una serie di regole. Per essere ancora più chiaro, è un intermediario dell'informazione. Le API consentono a un'applicazione di estrarre informazioni da un software e utilizzare tali informazioni nella propria applicazione o, talvolta, per l'analisi dei dati.

Nei termini più semplici, un'API è un progetto che consente alle "cose" di parlare e lavorare con "le loro cose". Il tuo materiale, in questo caso, è noto come "endpoint API".

Perché le API sono importanti?

Una delle prime domande che molti esperti di marketing chiedono è: perché tutte queste aziende condividono i loro dati apertamente, gratuitamente?

Normalmente, la risposta è: scala. Man mano che le società di software crescono, lo staff di queste aziende si rende subito conto di avere più idee di quante ne abbiano il tempo e le risorse per svilupparle.

Creando API, le aziende consentono agli sviluppatori di terze parti di creare applicazioni in grado di migliorare l'utilizzo e l'adozione della piattaforma principale. In questo modo, un'azienda può creare un ecosistema che diventa dipendente dai dati della sua API, una dinamica che spesso porta a ulteriori opportunità di guadagno.

Come utilizzare un'API

Comprendere il valore di una particolare API significa essenzialmente capire quali informazioni sono disponibili attraverso un'API e come è possibile accedervi. Per scoprire che cosa può fare una determinata API per te, puoi fare una delle due cose.

1. Chiedi a uno sviluppatore web di guardare un'API e discuterne con te.
2. Fai la ricerca da solo. Se non hai accesso o budget per utilizzare uno sviluppatore web, questa è un'opzione interessante. Ma non fatevi prendere dal panico: molti servizi online hanno una buona documentazione API.

Documentazione API

Diamo un'occhiata veloce Indice di riferimento API di Twitter come esempio:

Gran parte della crescita di Twitter è dovuta a sviluppatori esterni e la prima API di Twitter è stata avviata come wiki di base. Da allora, si è evoluto in un dettaglio indice di API che un esperto di marketing può utilizzare per determinare quali informazioni potrebbero essere disponibili per uno sviluppatore sotto forma di API e come includere questa API sul tuo sito web.

Guardando lo screenshot qui sopra, puoi vedere che ci sono più categorie di informazioni disponibili per gli sviluppatori esterni. Dopo aver selezionato un'API a cui sei interessato, puoi fare clic su di essa per vedere quali informazioni sono disponibili tramite questa API. Consulta API della timeline Twitter di Twitter, di seguito.

Nella documentazione dell'API sopra, l'API della Timeline della Twitter di Twitter spiega come puoi prendere una breve raccolta di tweet recenti dalla timeline di un utente specifico e visualizzarli, in forma cliccabile, sul tuo sito web. La documentazione dell'API include le limitazioni del volume dei tweet, l'URL delle risorse dell'API e ciò che puoi e non puoi scegliere di visualizzare attraverso questa API.

Applicazione dell'API al tuo sito web

Se aggiungi l'URL della risorsa dell'API al back-end del tuo sito web, restituirà le informazioni richieste per il frontend del tuo sito web. Ecco come appare sul sito di New York Road Runners, aiutandoli a promuovere la Maratona di New York City (con alcune modifiche al design personalizzato):

Puoi anche consultare la documentazione dell'HubSpot API per vedere come è possibile creare applicazioni e integrazioni utilizzando i dati di HubSpot.

Un ultimo avvertimento: per poter utilizzare ufficialmente l'API di uno sviluppatore, potrebbe anche essere necessario assegnare una chiave API.

Pensa alla tua chiave API come token di autenticazione, dichiarandoti membro della community di uno sviluppatore. In effetti, questo token identifica per che cosa stai utilizzando l'API e verifica che ti sia stata concessa l'autorizzazione per eseguire questo progetto dal proprietario dell'API.

Ti assicuro, la tua chiave API fa non dare allo sviluppatore l'accesso a informazioni personali su di te.

API come piattaforma di marketing

Il marketing in un mondo inbound riguarda le aziende che sviluppano applicazioni e servizi utili a sostenere la fidelizzazione dei clienti. I brand dovranno abbandonare la pubblicità a intermittenza per diventare canali di comunicazione dei consumatori.

In tale processo, le API facilitano i dati necessari per fornire soluzioni ai problemi dei clienti.

Esempi di API

Capire quali informazioni sono disponibili tramite un'API aiuterà a determinare se vale la pena lavorare con uno sviluppatore per perseguire ulteriormente il progetto. Ecco due esempi:

Menzioni su Twitter

Se volevi mostrare tweet sul tuo sito web che includevano menzioni su Twitter ad articoli del tuo blog, dovresti capire se puoi richiedere tweet con solo URL specifici dall'API di Twitter.

Incorporamento video di YouTube

Quando fai clic con il pulsante destro del mouse su un video di YouTube su youtube.com e selezioni "Copia codice di incorporamento", stai essenzialmente richiedendo l'utilizzo dell'API di YouTube sul tuo sito web. YouTube rende facile per il pubblico incorporare i video di YouTube per riprodurre direttamente su altri siti web.

Termini di servizio dell'API

Indipendentemente dal progetto, è fondamentale che tu legga e comprenda effettivamente i termini di servizio per un'API che stai prendendo in considerazione per il tuo sito web. La maggior parte delle API ha alcune limitazioni di utilizzo. Se non ti prendi il tempo necessario per comprendere le restrizioni di un'API a cui sei interessato, potresti investire più tempo e denaro nello sviluppo di un asset di marketing reso inutilizzabile una volta che il provider API ha stabilito che hai violato i termini di servizio dell'API (e revoca il tuo accesso).

Per questo motivo, la maggior parte delle API ha "limiti di chiamata".

Con questo in mente, un limite di chiamate API è il numero di volte in cui è possibile richiedere informazioni su un'API da un servizio Web entro un determinato periodo di tempo. Ancora una volta, leggi i termini di utilizzo per tutte le API che stai pensando di utilizzare. Questi documenti dovrebbero descrivere chiaramente ogni limitazione e l'uso appropriato del programma.

Lo sviluppo sulle API dei servizi Web esistenti è solo l'inizio. Viviamo in un mondo che ora si aspetta contenuti aperti e disponibili per tutti – la naturale evoluzione di questo è che gli editori stessi rilasciano le proprie API, in modo che loro i clienti possono sviluppare applicazioni come risultato.

La condivisione dell'API si applica a tutte le aziende, non solo a quelle basate sul Web, ma a chiunque disponga di uno strumento o componente Web della propria organizzazione. Ovviamente, questo concetto potrebbe causare ostacoli ad alcune organizzazioni, specialmente dal dipartimento legale. Spetta a te scoprire quali API sono più preziose e come puoi utilizzarle legittimamente e in modo sostenibile.