Cos'è la gestione delle API?

In genere, una piattaforma di gestione delle API con funzionalità complete include i seguenti strumenti:

Portali per gli sviluppatori: un sito in cui gli sviluppatori possono trovare le informazioni e le credenziali necessarie per utilizzare le API nelle loro app client. Il portale per gli sviluppatori può fornire agli sviluppatori documentazione interattiva, analisi orientate agli sviluppatori, informazioni sulla monetizzazione, stato di approvazione delle app e altri strumenti e servizi.

Progettazione e sviluppo: un'esperienza di sviluppo e un insieme di strumenti per la progettazione e la creazione di prodotti API e per consentire ai sistemi esistenti di utilizzare le API.

Test: consente di eseguire un'ampia gamma di test, dai test fittizi ai test funzionali, fino ai test sulle prestazioni e alla sicurezza delle API. 

Gateway API: un gateway API esegue la mediazione e l'applicazione delle chiamate API in fase di esecuzione.

Analisi e monitoraggio: le metriche operative, come l'utilizzo nel tempo, consentono agli sviluppatori di aumentare la velocità di deployment e l'affidabilità dell'API. La monetizzazione e le metriche aziendali, come le entrate generate tramite una determinata API, consentono alle organizzazioni di misurare lo stato di attività del proprio ecosistema di API.  

Gestione dei criteri: i criteri definiscono il funzionamento di un'API, inclusa la frequenza con cui i dati vengono memorizzati nella cache, la modalità di traduzione di protocolli e le quote per il loro utilizzo. Gestire questi criteri è un aspetto importante nella gestione di un'API.

Sicurezza e governance: le API richiedono standard coerenti per le autorizzazioni, l'autenticazione, la prevenzione degli usi illeciti e la connessione dell'identità alle credenziali client e sviluppatore. 

Gli strumenti di monitoraggio delle API vengono utilizzati per raccogliere e analizzare i dati relativi alle prestazioni di un'API. Gli strumenti di monitoraggio delle API consentono una valutazione completa delle metriche relative a prestazioni e utilizzo di una singola API, di una piattaforma API o anche di un intero ecosistema di API; forniscono informazioni su sviluppatori, product manager delle API e stakeholder interessati, nonché consentono la massima agilità e l'ottimizzazione delle prestazioni.

Le analisi contribuiscono ai report end-to-end su tutti gli aspetti del programma API, come il coinvolgimento degli sviluppatori, la geolocalizzazione dei consumatori, gli errori, la latenza, le prestazioni e altro ancora. In particolare, le analisi consentono ai project manager di ottimizzare l'adozione del programma API e le prestazioni offrendo visibilità e report granulari. Il monitoraggio delle API garantisce che le API siano disponibili e funzionino come previsto per garantire un'esperienza senza interruzioni ai consumatori. Una piattaforma di gestione delle API completa deve includere strumenti di monitoraggio delle API per svolgere le seguenti funzioni:

Analisi del traffico

Analizza il traffico complessivo in varie aree geografiche, cercando metriche sul traffico e di utilizzo come la percentuale di successo delle risposte dell'API, i codici di errore comuni o le transazioni al secondo.

Gli strumenti di analisi del traffico sono in grado di identificare la sorgente del traffico e determinare quale applicazione lo sta generando, ad esempio se il traffico proviene da un bot, un browser o una libreria. Da quale dispositivo proviene il traffico?

Tracciamento e osservabilità delle API

Assistenza per la risoluzione dei problemi e il monitoraggio dei proxy API in esecuzione su una piattaforma di gestione delle API. Il tracciamento delle API consente di analizzare i dettagli di ogni passaggio tramite un flusso proxy API e l'osservabilità aiuta gli sviluppatori a comprendere la latenza, le prestazioni e l'esecuzione di ogni passaggio in tempo reale. 

Analisi del rendimento

Gli strumenti di analisi delle prestazioni possono misurare il tempo di risposta dell'API, il tempo di risposta target e il numero di errori nelle aree geografiche per determinare le latenze dei proxy e dei target API. Il monitoraggio delle prestazioni delle API analizza i codici di errore e la composizione degli errori in proxy e target.

Disponibilità e monitoraggio delle prestazioni

Gli strumenti di monitoraggio delle API monitorano la disponibilità e le prestazioni delle API nell'intera catena del valore con livelli granulari di dettaglio. Gli strumenti di monitoraggio possono generare avvisi quando si verificano errori e ridurre i tempi di risoluzione, identificando l'origine degli errori nell'applicazione sviluppatore, nel livello proxy o nel target di backend. 

Coinvolgimento dello sviluppatore

Gli strumenti di monitoraggio delle API possono anche analizzare il modo in cui gli sviluppatori interagiscono con le API. Ad esempio, quali sviluppatori stanno generando la maggior parte del traffico API? In che modo consumano le API? Hanno letto la documentazione nel portale per gli sviluppatori?

Stato della sicurezza

Una delle funzioni principali di una piattaforma di gestione delle API è proteggere le API e i dati degli utenti malintenzionati, quindi gli strumenti di monitoraggio delle API dovrebbero sempre verificare la presenza di rischi e comportamenti dannosi, nonché l'integrità complessiva della sicurezza dell'ecosistema di API. 

Gli strumenti di monitoraggio della sicurezza devono essere in grado di esaminare le configurazioni delle API per assicurare che siano conformi ai criteri di sicurezza e ai requisiti di conformità dell'azienda. Inoltre, dovrebbero essere in grado di identificare le anomalie nei modelli di traffico, distinguere il traffico sicuro dalle potenziali minacce e capire chi accede ed esporta i dati sensibili, come le informazioni degli sviluppatori, le sessioni di traccia e le chiavi API.