Che cos'è il Centro API di Azure?

Il Centro API di Azure consente il rilevamento tutte le API di rilevamento 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.

Vantaggi

• Creare e gestire un inventario dell’organizzazione: le organizzazioni possono 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.

• Amministrare le API dell'organizzazione: con una visibilità più completa sulle API prodotte e usate all'interno di un'organizzazione, i responsabili dei programmi API e gli amministratori IT possono amministrare questo inventario per garantire che sia conforme agli standard dell’organizzazione attraverso la definizione di metadati personalizzati e l’analisi delle definizioni delle API, in modo da applicare la conformità alle linee guida per lo stile dell'API.

• Individuazione delle API semplificata: le organizzazioni vogliono promuovere il riutilizzo delle API per ottimizzare la produttività degli sviluppatori e garantire che utilizzino 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 eseguire le operazioni 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 l'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 Azure Gestione API.

• Progettazione e sviluppo di API: con 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 e GitHub Copilot per Azure per creare definizioni api da descrizioni di codice o linguaggio naturale.

• 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 delle API: organizzare e filtrare le API e le risorse correlate usando metadati predefiniti e personalizzati, in modo da facilitare la governance delle API e la loro individuazione da parte dei consumer di API. Configurare linting e analisi per applicare la qualità della definizione delle API.

  Gli sviluppatori di API possono controllare la conformità alla progettazione dell'API a sinistra in Visual Studio Code con 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 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 o un catalogo della piattaforma API a cui si accede usando l'estensione Di Visual Studio Code di Centro API di Azure.

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

Aree disponibili

Il Centro API di Azure è attualmente disponibile nelle aree 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 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 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 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 API di Contoso include quanto segue:

• 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. Un altro subset delle API viene distribuito 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 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 dell’organizzazione, gestendo le relative informazioni, tra cui le versioni e le distribuzioni associate.

Passaggi successivi