Panoramica delle risorse API

Questa pagina si applica a Apigee e Apigee ibridi.

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

Una risorsa API è un'entità complessa a cui possono essere associate una o più versioni. Una versione può essere considerata come lo stato di un'API in un determinato momento. Ogni versione può avere un proprio insieme di entità come le operazioni analizzate da una specifica API, i deployment, e le 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 seguito, puoi aggiungere e modificare gli attributi delle risorse API per creare una descrizione dettagliata dell'API. Vedi Gestire gli attributi.

L'hub API supporta sia gli attributi definiti dal sistema sia quelli definiti dall'utente. Esempi di attributi definiti dal sistema includono:

  • Stile API: un attributo con valori predefiniti REST, gRPC, SOAP e AsyncAPI.
  • Utenti di destinazione: gli utenti (consumatori) previsti di un'API.
  • Team: il team di produzione o i team 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.