Viviamo in un’epoca di astrazione, dove gli utenti finali non si preoccupano dei meccanismi interni, purché le loro esigenze siano soddisfatte.
La necessità di compattezza ha favorito la nascita delle API, considerate lo strumento ideale per l’integrazione di risorse digitali, sia interne che esterne, e per collegare diverse applicazioni.
Prendiamo ad esempio un ristorante: i clienti comunicano con i camerieri per esprimere le loro preferenze, consultano il menù per scegliere cosa ordinare e poi si rilassano gustando il pasto. Non sono tenuti a capire cosa succede dietro le quinte, come la preparazione degli ordini, le attività della cucina o altri dettagli operativi.
L’API si può paragonare al cameriere e al menù: il menù presenta le opzioni disponibili, mentre il cameriere comunica queste opzioni, raccoglie gli ordini e gestisce il pagamento.
Per molte aziende, le API sono semplicemente porzioni di codice che facilitano l’esecuzione di attività. Un sistema di gestione API può aiutare un’organizzazione a raggiungere l’interoperabilità dei dati tra varie applicazioni.
Nel mondo interconnesso di oggi, è necessario gestire le API in modo più sofisticato se si è coinvolti nell’economia delle API e si desidera considerarle come una fonte di guadagno o di crescita.
Cos’è l’analisi delle API?
L’analisi e il monitoraggio delle API si focalizzano su metriche di natura ingegneristica, come le prestazioni, il tempo di attività, le metriche di prodotto, la fidelizzazione e la conversione degli sviluppatori.
L’analisi API consente di filtrare, ordinare e aggregare i dati relativi agli eventi delle API, per poi presentare i risultati tramite grafici, tabelle e mappe.
Questi strumenti aiutano a gestire i livelli di servizio, a definire le quote, a stabilire i controlli, a impostare le politiche di sicurezza, a curare le community e ad analizzare le tendenze, attraverso diversi metodi, che vanno dall’uso di SQL ed Excel fino a piattaforme di analisi API dedicate.
KPI (Indicatori Chiave di Performance) per l’Analisi delle API
L’analisi delle API rivela tendenze significative che aiutano sia i responsabili IT che quelli aziendali a migliorare i KPI generati tramite l’analisi. Esaminiamo alcune informazioni chiave sulle prestazioni durante l’analisi e il monitoraggio delle API.
KPI Operativi
Latenza delle chiamate (media e massima): la latenza P1, o tempo di risposta, è un indicatore cruciale che impatta sull’esperienza dell’utente. Suddividere questo KPI in metriche più dettagliate, come tempi di rete, elaborazione del server e velocità di download, può fornire ulteriori spunti per valutare le prestazioni delle API.
Tassi di successo e di errore: l’efficacia delle operazioni API può essere misurata in base al numero di chiamate che generano codici di stato diversi da 200, aiutando le aziende a individuare API che potrebbero essere soggette a errori o bug. Per monitorare questi tassi, è fondamentale comprendere le tipologie di errori che si verificano durante l’utilizzo dell’API.
Accordi sul livello di servizio (SLA) delle API: benché sia una delle metriche più basilari, gli SLA sono il punto di riferimento per valutare la disponibilità di un servizio. Molti SLA aziendali lasciano poco margine di errore ai fornitori di software.
Per garantire questi livelli di servizio, le API a monte di un provider devono essere operative. Ciò richiede un monitoraggio e un’analisi delle API per assicurare il corretto funzionamento del servizio e per individuare rapidamente eventuali problemi.
KPI di Adozione
KPI per gli sviluppatori di adozione delle API: questo obiettivo mira a promuovere l’adozione delle API. Le aziende dovrebbero valutare l’utilizzo di questo parametro insieme ad altri indicatori che confermano l’utilità aziendale di una specifica API.
Traffico API: monitorando e migliorando il valore delle API, si può favorire una forte cultura DevOps. Le aziende dovrebbero considerare questo obiettivo insieme ad altre metriche correlate a monte e a valle della catena del valore, come l’affidabilità e la scalabilità del backend.
Adozione del prodotto API: i modelli chiave nell’adozione delle API possono essere identificati attraverso la retention e l’abbandono. Un prodotto con un alto tasso di retention, ad esempio, è più vicino a trovare il suo spazio nel mercato rispetto a uno con problemi di abbandono. Invece della retention dell’abbonamento, la retention del prodotto traccia l’utilizzo effettivo, come nel caso di un’API.
KPI per l’Impatto Aziendale
Ricavi, sia diretti che indiretti: uno degli scopi di questi obiettivi è monitorare come le API contribuiscono al fatturato. Le aziende possono monetizzare direttamente le API offrendole come servizi a pagamento a partner e sviluppatori esterni, fornendo accesso a dati specifici o a funzionalità di grande valore e difficili da replicare.
Tuttavia, un’API può generare più valore se le aziende si concentrano sull’adozione piuttosto che sui ricavi iniziali.
Partner: questo obiettivo può essere utilizzato per ampliare la rete di partner, promuovere l’adozione e dimostrare il successo alle unità aziendali esistenti.
Costo: riutilizzando le API, invece di avviare nuovi progetti di integrazione personalizzata per ogni nuova esigenza, le aziende possono risparmiare denaro.
Quando gli sviluppatori utilizzano API standardizzate per connettersi a dati e servizi esistenti, le aziende possono identificare i casi in cui le API riutilizzabili hanno generato risparmi, evitando nuovi progetti di integrazione, monitorando l’utilizzo delle API.
Allo stesso modo, dato che le API automatizzano e accelerano diversi processi, le aziende possono identificare come specifiche API contribuiscono all’accelerazione dei cicli di sviluppo, al rapido completamento di processi aziendali e al risparmio di risorse.
Vediamo ora alcune delle migliori soluzioni per l’analisi delle API.
Moesif
Moesif è un eccellente strumento per il monitoraggio delle API. Non solo permette di tracciare tutte le richieste, inclusi i payload di richiesta/risposta, ma consente anche di effettuare query utilizzando qualsiasi parametro.
In pochi secondi, è possibile creare query come “Mostra le entità richieste mensilmente dall’azienda A con un tempo di risposta superiore a X”.
L’interfaccia utente per le query è semplice e potente e supporta varie operazioni. Un altro vantaggio è la facilità di integrazione di Moesif con le applicazioni, che consente l’integrazione in tutti gli ambienti. Tutte le richieste inviate a Moesif sono elencate e ricercabili.
APImetrics
APImetrics ha sviluppato il primo sistema di monitoraggio delle prestazioni end-to-end, pensato per sviluppatori, fornitori di API e organizzazioni. Utilizzando APImetrics, è possibile automatizzare il test di latenza e prestazioni delle API che si forniscono o si utilizzano e fornire dati in tempo reale a clienti e partner tramite dashboard e API di reporting.
Il monitoraggio API di APImetrics permette di identificare i problemi non appena si verificano, prima che possano danneggiare i clienti o la reputazione dell’azienda.
Sentinet Nevatech
Sentinet Nevatech è una soluzione per la gestione e la governance delle API che supporta gli standard REST e SOAP e protocolli di comunicazione e modelli di sicurezza specifici di Microsoft.
La visualizzazione dei dati può essere effettuata utilizzando i report e le dashboard integrati di Sentinet, con la possibilità di personalizzare i report aggiungendone di propri.
Grazie all’analisi predittiva di Sentinet, è possibile anticipare le necessità future di utilizzo, prestazioni e scalabilità. Gli indicatori chiave di prestazione (KPI) possono essere facilmente classificati e visualizzati nelle dashboard.
Smartbear ReadyAPI
ReadyAPI permette ai team di configurare, gestire ed eseguire test funzionali, di sicurezza e di prestazioni automatizzati in un’unica piattaforma. ReadyAPI accelera la qualità delle API per i team software Agile e DevOps.
È possibile aggiungere definizioni API come OpenAPI/Swagger o AsyncAPI, eseguire test e registrare il traffico API in tempo reale o virtualizzare i servizi web per rimuovere le dipendenze dalla pipeline.
Un semplice click permette di eseguire test API funzionali dettagliati e basati sui dati. È inoltre possibile aggiungere scansioni di sicurezza con un solo click. ReadyAPI consente di verificare la capacità dell’API di gestire test di carico, stress e picchi di traffico.
Servizi web RESTful, SOAP, TCP, JMS e altri possono essere virtualizzati in modo da non doverli utilizzare nella pipeline di test.
IBM API Connect
IBM API Connect è un ottimo strumento per lo sviluppo, l’amministrazione e il monitoraggio degli endpoint API ed è disponibile gratuitamente. È compatibile con meccanismi di sicurezza dell’autenticazione API come OAUTH, MTLS, JWK, ecc. Permette di personalizzare le API utilizzando YAML e componenti dell’interfaccia utente grafica.
IBM API Connect consente di creare, gestire, proteggere e socializzare le API in ambienti cloud ibridi, utilizzando un’unica piattaforma. Le tecnologie basate su modelli semplificano l’individuazione delle API esistenti e delle origini dati di back-end, rispetto ai metodi tradizionali.
È possibile creare un portale per sviluppatori dedicato alle proprie API, per promuoverle e commercializzarle. La gestione dei privilegi di utilizzo delle API, per monitorare chi le utilizza, quando e con quale frequenza, diventa semplice. Si possono ottenere dati completi sull’utilizzo e sulla qualità del servizio, filtrando le ricerche e la navigazione.
Mulesoft Anypoint
Anypoint API Manager fa parte della Piattaforma Anypoint, che permette di gestire, controllare e proteggere le API. L’analisi delle API permette di monitorare come vengono utilizzate e come funzionano.
È possibile monitorare il numero di utenti e le loro prestazioni. API Manager consente di creare dashboard, personalizzare grafici e generare report. Un report di API Manager include l’analisi dei dati API, il monitoraggio degli eventi API e la visualizzazione di grafici.
Google APIGEE
In quanto piattaforma leader per la gestione delle API, Apigee permette alle aziende digitali di crescere. Molte aziende Fortune 100 e marchi come First Data, Live Nation, Shell, Burberry, eBay e Walgreens usano questo servizio quotidianamente. Apigee, con sede in California, impiega più di 400 persone in tutto il mondo.
Oltre alla gestione e all’analisi degli sviluppatori API, Apigee Edge offre una piattaforma di amministrazione API semplice e potente. Il programma gestisce bene l’aumento del traffico degli utenti.
Fornisce un sito di sviluppo API per uso interno, facilitando la condivisione di informazioni tra i dipendenti. Il controllo degli accessi, OAuth, la verifica della chiave API e la protezione dalle minacce XML/JSON sono alcune delle tecniche disponibili per proteggere back-end, API e comunicazioni.
Conclusione 👇
Il successo nell’utilizzo di un prodotto API varia da persona a persona e i KPI specifici per il prodotto differiranno da quelli di un’altra azienda.
Le aziende del settore fintech, ad esempio, potrebbero essere interessate a conoscere quanti utenti hanno utilizzato la loro API per effettuare pagamenti. Nel caso di un’azienda di e-commerce, si vorrà sapere quante persone si sono iscritte alla newsletter tramite un’API email.
Le analisi delle API vengono utilizzate per raggiungere gli obiettivi della propria azienda, a prescindere dalla sua natura. Avere un’API non garantisce automaticamente il successo. L’utilizzo della nuova API aziendale in modo basato sui dati, analitico e mirato, porterà invece risultati.
Si possono approfondire i migliori strumenti per la creazione di API.