Panoramica delle risorse API

Questa pagina si applica ad Apigee e Apigee hybrid.

Quando registri un'API con l'hub API, crei e memorizzi un'entità che la rappresenta. Chiamiamo questa entità risorsa API. Le risorse API archiviate nell'hub API sono disponibili per la ricerca e forniscono informazioni operative e descrittive dettagliate sull'API.

Una risorsa API è un'entità complessa a cui possono essere associate una o più versioni. Puoi pensare a una versione come allo stato di un'API in un determinato momento. Ogni versione può avere il proprio insieme di entità, come operazioni analizzate da una specifica dell'API, deployment e specifiche dell'API, come mostrato nella Figura 1.

Relazioni tra entità dell'API.

Figura 1. Un'API può avere più versioni.

Al momento della registrazione di un'API o in un secondo momento, puoi aggiungere e modificare gli attributi delle risorse dell'API per creare una descrizione completa dell'API. Vedi Gestire gli attributi.

L'hub API supporta sia gli attributi definiti dal sistema sia quelli definiti dall'utente. Ecco alcuni esempi di attributi definiti dal sistema:

  • Stile API: un attributo con valori predefiniti REST, gRPC, SOAP e AsyncAPI.
  • Utenti target: gli utenti previsti (consumatori) di un'API
  • Team: il team o i team di produzione responsabili di un'API
  • Unità aziendale: l'unità aziendale responsabile di un'API
  • Livello di maturità: un'indicazione della fase del ciclo di vita dell'API

Infine, una risorsa API può avere attributi definiti dall'utente, che puoi definire in Impostazioni in base alle esigenze della tua organizzazione o del tuo team.