Che cos'è il Centro API di Azure?

Il Centro API di Azure consente di tenere traccia di tutte le API in una posizione centralizzata per l'individuazione, il riutilizzo e la governance. Usare un centro API per sviluppare e gestire un inventario strutturato e organizzato delle API dell'organizzazione, indipendentemente dal tipo, dalla fase del ciclo di vita o dal percorso di distribuzione, insieme a informazioni correlate, ad esempio dettagli della versione, file di definizione dell'API e metadati comuni.

Con un centro API, gli stakeholder in tutta l'organizzazione, inclusi i responsabili dei programmi API, gli amministratori IT, gli sviluppatori di applicazioni e gli sviluppatori di API, possono individuare, riutilizzare e gestire le API.

Nota

Centro API di Azure è una soluzione per la governance delle API in fase di progettazione e l'individuazione centralizzata delle API. Azure offre anche il servizio Gestione API, una soluzione per la governance delle API di runtime e l'osservabilità usando un gateway API. Altre informazioni sulle differenze e sul modo in cui il Centro API di Azure e Gestione API possono collaborare.

Vantaggi

• Creare e gestire un inventario aziendale: le organizzazioni possono creare un inventario completo delle API disponibili nell'organizzazione. Promuovere la comunicazione e consentire ai responsabili dei programmi API e agli sviluppatori di collaborare per aumentare il riutilizzo delle API, la qualità, la sicurezza, la conformità e la produttività degli sviluppatori.

• Governance delle API dell'organizzazione: con maggiore visibilità sulle API prodotte e usate all'interno di un'organizzazione, i responsabili dei programmi API e gli amministratori IT possono gestire questo inventario per garantire che soddisfi gli standard dell'organizzazione definendo metadati personalizzati e analizzando le definizioni api per applicare la conformità alle linee guida per lo stile api.

• Individuazione semplificata delle API : le organizzazioni vogliono promuovere il riutilizzo delle API per ottimizzare la produttività degli sviluppatori e assicurarsi che gli sviluppatori usino le API corrette. Centro API di Azure aiuta i responsabili dei programmi e gli sviluppatori a individuare l'inventario e filtrare le API usando metadati predefiniti e personalizzati. ​

• Accelerare il consumo delle API: ottimizzare la produttività degli sviluppatori quando usano le API e assicurarsi che vengano utilizzate in modo sicuro e coerente con gli standard dell'organizzazione.

Funzionalità chiave

Creare e usare un centro API per gli elementi seguenti:

• Gestione inventario API: registrare tutte le API dell'organizzazione per l'inclusione in un inventario centralizzato.

• Rappresentazione dell'API reale: aggiungere informazioni reali su ogni API, incluse versioni e definizioni, ad esempio definizioni OpenAPI. Elencare le distribuzioni api e associarle agli ambienti di runtime, ad esempio, che rappresentano azure Gestione API o altre soluzioni di gestione API.

• Governance api: organizzare e filtrare LE API e le risorse correlate usando metadati predefiniti e personalizzati, per facilitare la governance e l'individuazione delle API da parte dei consumer di API. Configurare l'linting e l'analisi per applicare la qualità delle definizioni API.

• Individuazione e riutilizzo delle API: consente agli sviluppatori e ai responsabili di programmi API di individuare le API tramite il portale di Azure, un portale del Centro API e gli strumenti di sviluppo, inclusa un'estensione di Visual Studio Code.

Per altre informazioni sulle entità che è possibile gestire e sulle funzionalità nel Centro API di Azure, vedere Concetti chiave.

Aree disponibili

Il Centro API di Azure è attualmente disponibile nelle aree di Azure seguenti:

• Australia orientale
• India centrale
• Stati Uniti orientali
• Regno Unito meridionale
• Europa occidentale

Il Centro API è disponibile in un piano gratuito e in un piano Standard. Altre informazioni.

Centro API di Azure e ecosistema di API

Il Centro API di Azure può svolgere un ruolo chiave nell'ecosistema di API di un'organizzazione. Si consideri l'ipotetica organizzazione Contoso, che ha adottato una strategia API-first, enfatizzando l'importanza delle API nello sviluppo e nell'integrazione del software.

Gli sviluppatori di API, gli sviluppatori di app, i responsabili dei programmi API e i responsabili API di Contoso collaborano tramite il Centro API di Azure per sviluppare e usare l'inventario API dell'organizzazione. Vedere il diagramma e la spiegazione seguenti.

L'ecosistema di API di Contoso include quanto segue:

• Sviluppo di API: gli sviluppatori di Contoso compilano regolarmente api Web ASP.NET. Creano anche Funzioni di Azure con trigger HTTP.

• Ambienti di distribuzione api: Contoso distribuisce una parte delle API nel servizio app Azure. Un altro subset delle API viene distribuito in un'app per le funzioni di Azure.

• Azure Gestione API: Contoso usa il servizio azure Gestione API per gestire, pubblicare e proteggere le API. Usano istanze separate per sviluppo, test e produzione, ognuna con un nome distinto: APIM-DEV, APIM-TEST e APIM-PROD.

• Centro API di Azure: Contoso ha adottato il Centro API di Azure come hub centralizzato per l'individuazione, la governance e l'utilizzo delle API. Il Centro API funge da hub API strutturato e organizzato che fornisce informazioni complete su tutte le API organizzative, mantenendo informazioni correlate, incluse le versioni e le distribuzioni associate.

Passaggi successivi

Configurare il centro API - Portale