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.

Suggerimento

Introduzione al Centro API è stata semplificata. Il piano gratuito è ora disponibile senza vincoli di tempo. Si applicano i limiti.

Usando 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 progettare, 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 servizi complementari, ad esempio Azure Gestione API, una soluzione per la governance delle API di runtime e l'osservabilità usando un gateway API. Altre informazioni sulle differenze e sulle modalità di collaborazione tra Centro API di Azure e Gestione API.

Vantaggi

• Creare e gestire un inventario aziendale : creare un inventario completo delle API disponibili nell'organizzazione. Registrare le API gestite in tutte le soluzioni di gestione delle API, tra cui Gestione API di Azure e piattaforme di altri provider. Includere anche le API non gestite e quelle in fase di sviluppo. Incoraggiare 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à completa sulle API sviluppate e usate all'interno dell'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 : promuovere il riutilizzo dell'API per ottimizzare la produttività degli sviluppatori e assicurarsi che gli sviluppatori usino le API corrette. Centro API di Azure consente ai responsabili dei programmi e agli sviluppatori di individuare l'inventario delle API e di filtrarle usando metadati predefiniti e personalizzati. ​

• Accelerare il consumo di API : ottimizzare la produttività degli sviluppatori quando usano le API e assicurarsi che vengano utilizzate in modo sicuro e conforme agli standard dell’organizzazione.

Funzionalità chiave

Creare e usare un centro API per le funzionalità seguenti:

• Gestione dell'inventario API : gli sviluppatori di API e i responsabili di programmi API possono registrare tutte le API dell'organizzazione per l'inclusione in un inventario centralizzato usando il portale di Azure, l'interfaccia della riga di comando di Azure, gli strumenti per sviluppatori, ad esempio pipeline CI/CD, e collegamenti a origini API come i servizi di Gestione API di Azure.

• Progettazione e sviluppo di API : usando l'estensione Centro API di Azure per Visual Studio Code, gli sviluppatori possono registrare le API direttamente dallo stesso ambiente di sviluppo in cui creano le API e le app.

  Gli sviluppatori possono sfruttare l'integrazione dell'estensione con GitHub Copilot per creare definizioni api dal codice e con GitHub Copilot per Azure per progettare API con assistenza per l'intelligenza artificiale.

• Rappresentazione delle API nel mondo reale: aggiungere informazioni relative al mondo reale per ogni API, tra cui versioni e definizioni, ad esempio le definizioni OpenAPI. Elencare le distribuzioni dell'API e associarle agli ambienti di runtime, ad esempio rappresentando Gestione API di Azure 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 linting e analisi per applicare la qualità della definizione delle API.

  Gli sviluppatori di API possono anticipare i controlli di conformità del design dell'API in Visual Studio Code utilizzando il supporto di linting integrato e il rilevamento delle modifiche rivoluzionarie. Eseguire l'integrazione con strumenti come Dev Proxy per assicurarsi che le app non usino API shadow o API non conformi agli standard dell'organizzazione.

• Individuazione e riutilizzo delle API : consente agli sviluppatori aziendali e ai responsabili di programmi API di individuare le API tramite un portale di Centro API. È anche possibile abilitare il portale usando l'estensione Centro API di Azure per Visual Studio Code.

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

Livelli e SKU

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

Nota

Il Centro API di Azure è ora incluso gratuitamente con i livelli Premium e Standard di Gestione API di Azure.

Aree disponibili

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

• Australia orientale
• Canada Central
• India centrale
• Stati Uniti orientali
• Francia centrale
• Svezia centrale
• Regno Unito meridionale
• Europa occidentale

Centro API di Azure ed ecosistema API

Il Centro API di Azure può svolgere un ruolo chiave nell'ecosistema API di un'organizzazione. Si consideri l'ipotetica organizzazione Contoso, che adotta 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 gestori di programmi per le API e i gestori delle 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 le funzionalità seguenti:

• Sviluppo 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 di Azure. Distribuiscono un altro subset delle API in un'app per le funzioni di Azure.

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

• Centro API di Azure : Contoso adotta 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 dell’organizzazione, gestendo le relative informazioni, tra cui le versioni e le distribuzioni associate.

Passaggi successivi

Configurare il Centro API - portale