Un'interfaccia REST che consente a un'applicazione di utilizzare facilmente funzionalità o dati di un'altra applicazione. Definendo punti di contatto stabili, semplici e ben documentati, le API consentono agli sviluppatori di accedere e riutilizzare facilmente la logica di applicazione creata da altri sviluppatori.
Creato quando carichi una definizione dell'API in API Gateway. Ogni volta che carichi una definizione di API, API Gateway crea una nuova configurazione API. In altre parole, puoi creare una configurazione API, ma non puoi modificarla in un secondo momento. Se in un secondo momento modifichi la definizione dell'API e poi la carichi, viene creata una nuova configurazione API.
Una specifica Open API 2.0 o una configurazione gRPC utilizzata per creare una configurazione API. Una definizione di API specifica: l'URL del servizio di backend, il formato dei dati trasmessi in una richiesta, il formato di eventuali dati restituiti dal servizio, il meccanismo di autenticazione utilizzato per controllare l'accesso al servizio e molte altre opzioni.
Un codice passato da un'applicazione client quando chiama un'API. Le chiavi API identificano l'applicazione o il Google Cloud progetto che esegue la chiamata all'API. Per ulteriori informazioni sull'utilizzo di una chiave API con l'API API Gateway, consulta Perché e quando utilizzare le chiavi API.
La condivisione delle risorse tra origini (CORS) è una specifica che consente alle applicazioni web di accedere alle risorse su un server in un altro dominio (tecnicamente, in un'altra origine). Per saperne di più su CORS, consulta la documentazione web di Mozilla Developer Network (MDN) e Fetch Living Standard.
Servizio di autenticazione di Google che supporta l'accesso degli utenti finali alle applicazioni client utilizzando le credenziali di provider di identità federati come Google, Facebook o Twitter. Per saperne di più, consulta la sezione sull'autenticazione Firebase.
Un proxy scalabile e ad alte prestazioni basato su Envoy che ospita la configurazione dell'API di cui è stato eseguito il deployment. La creazione di un gateway genera l'URL rivolto all'esterno utilizzato dai client API per accedere all'API. Un gateway ospita una sola configurazione API. Non puoi eseguire il deployment di più configurazioni API nello stesso gateway.
Un token web JSON (JWT) che contiene i campi OpenID Connect necessari per identificare un account utente o un account di servizio Google e che è firmato dal servizio di autenticazione di Google, https://accounts.google.com.
Un framework RPC universale open source ad alte prestazioni sviluppato da Google.
In gRPC, un'applicazione client può chiamare direttamente i metodi di un'applicazione server su un'altra macchina come se fosse un oggetto locale. Consulta la panoramica di gRPC per informazioni sull'utilizzo di gRPC con API Gateway e il sito web di gRPC per informazioni generali.
Il token web JSON è un formato di token di accesso standard aperto da utilizzare nelle intestazioni di autorizzazione HTTP e nei parametri di query URI.
Per informazioni generali, consulta la pagina Introduzione ai token web JSON.
L'Open API Initiative è un progetto a livello di settore per
standardizzare la descrizione delle API REST. Le API descritte con la
specifica OpenAPI (in precedenza
specifica Swagger) possono essere supportate con strumenti comuni
che creano documentazione, automatizzano i test e generano codice per i client
e i server. Per ulteriori informazioni, consulta la panoramica di OpenAPI.
Un file in formato YAML o JSON che utilizzi per descrivere l'API.
Questo file è noto anche come definizione dell'API.
Quando viene caricato in API Gateway, il documento OpenAPI viene convertito in una configurazione API.
[[["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-03 UTC."],[[["\u003cp\u003eThis page provides definitions and links to further information for terms used within the API Gateway documentation.\u003c/p\u003e\n"],["\u003cp\u003eAPI definitions, created using OpenAPI or gRPC configurations, specify backend service URLs, data formats, and authentication mechanisms, among other options.\u003c/p\u003e\n"],["\u003cp\u003eAn API config is created each time an API definition is uploaded to API Gateway and is not modifiable, requiring a new upload for any edits.\u003c/p\u003e\n"],["\u003cp\u003eGateways, which are Envoy-based proxies, host a deployed API config and provide the external URL that clients use to access the API, with each gateway supporting only one API config.\u003c/p\u003e\n"],["\u003cp\u003eAPI keys are codes used by client applications to identify themselves or their Google Cloud project when calling an API.\u003c/p\u003e\n"]]],[],null,["# Glossary\n========\n\nThis page provides brief definitions and links to more information of terms\nthat are used in the API Gateway documentation.\n\nAPI\n: A REST interface that makes it easy for one application to consume capabilities or data from another application. By defining stable, simple, and well-documented entry points, APIs enable developers to easily access and reuse application logic built by other developers.\n\nAPI config\n: Created when you upload an [API definition](#api_definition) to API Gateway. Each time you upload an API definition, API Gateway creates a new API config. That is, you can create an API config but you cannot later modify it. If you later edit the API definition, and then upload the edited API definition, you create a new API config.\n\nAPI definition\n: An [Open API 2.0](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md) spec\n or [gRPC](http://www.grpc.io) configuration used to create an [API config](#api_config). An API definition specifies: the URL of the backend service, the data format of data passed on a request, the data format of any data returned by the service, the authentication mechanism used to control access to the service, and many more options.\n\nAPI key\n: A code passed in by a client application when it calls an API. API\n keys identify the application or the Google Cloud project making\n the call to the API. See\n [Why and when to use API keys](/endpoints/docs/openapi/when-why-api-key)\n for more information on using an API key with your API Gateway API.\n\nAuth0\n: A service that lets you define how users authenticate to applications. See\n [Auth0](https://auth0.com) for more information.\n\nCORS\n: Cross-Origin Resource Sharing (CORS) is a specification that provides a way\n for web applications to access resources on a server in another domain\n (technically, in another origin). To learn more about CORS, see the\n [Mozilla Developer Network (MDN) web docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)\n and the [Fetch Living Standard](https://fetch.spec.whatwg.org/).\n\nFirebase authentication\n: Google's authentication service that supports end user sign-in for client\n applications by using credentials from popular federated identity providers\n such as Google, Facebook, or Twitter. See\n [Firebase authentication](https://firebase.google.com/docs/auth/)\n for more information.\n\nGateway\n: An [Envoy](https://www.envoyproxy.io/docs/envoy/latest/)-based, high-performance, scalable proxy that hosts the deployed [API config](#api_config). Creating a gateway creates the external facing URL that your API clients use to access the API. A gateway only host a single API config. You cannot deploy multiple API configs to the same gateway.\n\nGoogle ID token\n: A JSON Web Token (JWT) that contains the\n [OpenID Connect](https://developers.google.com/identity/protocols/OpenIDConnect)\n fields needed to identify a Google user account or service account, and that\n is signed by Google's authentication service, `https://accounts.google.com`.\n\ngRPC\n: A high performance, open source universal RPC framework developed by Google.\n In gRPC, a client application can directly call methods on a server application\n on a different machine as if it was a local object. See\n [gRPC Overview](/api-gateway/docs/grpc-overview)\n for information on using gRPC with API Gateway and the\n [gRPC](http://www.grpc.io)\n website for general information.\n\nJWT\n: JSON Web Token is an open standard access token format for use in HTTP\n Authorization headers and URI query parameters.\n See [Introduction to JSON Web Tokens](https://jwt.io/introduction/)\n for general information.\n\nOpenAPI\n: The [Open API Initiative](http://openapis.org) is an industry-wide effort to\n standardize the description of REST APIs. APIs that are described with the\n [OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification) (formerly\n the [Swagger Specification](http://swagger.io)) can be supported with common\n tools that create documentation, automate testing, and generate code for clients\n and servers. See [OpenAPI overview](/api-gateway/docs/openapi-overview)\n for more information.\n\nOpenAPI document\n: A file in either YAML or JSON format that you use to describe your API.\n This file is also referred to as an [API definition](#api_definition).\n When uploaded to API Gateway, the OpenAPI document is converted to an [API config](#api_config).\n\nSurface\n: The public interface of an [API](#api_def). An API's surface consists of the methods\n as well as the parameters and return types used in the methods."]]
