Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
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.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eThis page focuses on API resources within Apigee and Apigee hybrid, representing registered APIs in API Hub.\u003c/p\u003e\n"],["\u003cp\u003eAn API resource is a complex entity that can have multiple versions, each with its own set of associated entities like operations, deployments, and API specifications.\u003c/p\u003e\n"],["\u003cp\u003eAPI resources can be enriched with attributes that describe them, which include both system-defined and user-defined types.\u003c/p\u003e\n"],["\u003cp\u003eSystem-defined attributes for an API include details like its style (REST, gRPC, etc.), target users, responsible team, business unit, and maturity level.\u003c/p\u003e\n"]]],[],null,["# API resources overview\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\nWhen you register an API with API hub, you create and store an entity that represents the API. We call\nthis entity an **API resource**. API resources stored in API hub are searchable and provide detailed\noperational and descriptive information about the API.\n\nAn API resource is a complex entity that can have one or more versions associated with it.\nYou can think of a version as the state of an API at a point in time. Each version can have\nits own set of entities such as [operations parsed from an API specification](./specs-intro#specificationparsing), [deployments](/apigee/docs/apihub/deployments-intro),\nand [API specifications](/apigee/docs/apihub/specs-intro), as shown in Figure 1.\n\n**Figure 1.** An API can have multiple versions.\n\nEither at the time you register an API or afterwards,\nyou can add and edit API resource attributes to build\na rich description of the API. See [Manage attributes](./manage-attributes).\n\nAPI hub supports both system-defined and user-defined attributes. Examples of system defined attributes include:\n\n- **API style**: An attribute with default values of REST, gRPC, SOAP, and Async API.\n- **Target users**: The intended users (consumers) of an API\n- **Team**: The producing team or teams responsible for an API\n- **Business unit**: The business unit responsible for an API\n- **Maturity level**: An indication of the API's lifecycle stage\n\nFinally, an API resource can have [user-defined attributes](./manage-attributes#user-attributes), which you define in Settings based on your\norganizational or team needs."]]
