Condividi tramite

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 dalla posizione di distribuzione, oltre a informazioni correlate quali dettagli della versione, file di definizione dell'API e metadati comuni.

Suggerimento

È possibile iniziare rapidamente a usare il Centro API di Azure sfruttando il piano gratuito, senza vincoli di tempo. Confronta i limiti del piano gratuito e del piano Standard.

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.

Note

Il 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 Gestione API di Azure, una soluzione per la governance delle API di runtime e l'osservabilità usando un gateway API. Esaminare le differenze e vedere come possono collaborare.

Vantaggi

Il Centro API di Azure offre i vantaggi seguenti:

  • 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 API, tra cui Gestione API di Azure e piattaforme di altri provider. Includere anche le API non gestite e quelle in fase di sviluppo. Favorire la comunicazione e permettere agli sviluppatori e ai responsabili dei programmi API di collaborare per aumentare il riutilizzo delle API, la qualità, la sicurezza, la conformità e la produttività degli sviluppatori.

  • Gestire le API dell'organizzazione: accedere a una visibilità più 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 dell'API.

  • Individuazione api semplificata: promuovere il riutilizzo dell'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 il filtro delle API 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 coerenti con gli standard dell'organizzazione.

Funzionalità principali

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

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

  • Progettazione e sviluppo di API: consente agli sviluppatori di usare l'estensione Centro API di Azure per Visual Studio Code per 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 da GitHub Copilot per Azure per progettare API con assistenza per l'intelligenza artificiale.

  • Rappresentazione dell'API reale: aggiungere informazioni reali su ogni API, incluse le versioni e le definizioni, ad esempio le definizioni OpenAPI. Creare un elenco di distribuzioni delle API e associarle agli ambienti di runtime, ad esempio rappresentare API Management 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à della progettazione delle API in Visual Studio Code usando il supporto di linting integrato e il rilevamento delle modifiche di rilievo. Eseguire l'integrazione con strumenti come Dev Proxy per assicurarsi che le app non usino API shadow non registrati o API che non soddisfano gli standard dell'organizzazione.

  • Individuazione e riutilizzo delle API: consentire agli sviluppatori aziendali e ai responsabili di programmi API di individuare le API tramite un portale del Centro API di Azure. È 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 di Azure è disponibile in un piano gratuito e in un piano Standard.

Note

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

Aree disponibili

Il Centro API di Azure è attualmente disponibile nelle aree di Azure 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 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 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 responsabili di programmi API e di API di Contoso collaborano tramite il Centro API di Azure per sviluppare e usare l'inventario di API dell'organizzazione. Il diagramma e la spiegazione seguenti illustrano questo scenario:

Diagramma che mostra il Centro API di Azure in un ecosistema api di esempio.

L'ecosistema di API di Contoso include le funzionalità seguenti:

  • 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 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 di Azure funge da hub API strutturato e organizzato che fornisce informazioni complete su tutte le API dell'organizzazione, mantenendo informazioni correlate, incluse le versioni e le distribuzioni associate.

Contenuti correlati

  • Last updated on