Glossario

Questa pagina fornisce brevi definizioni e link a ulteriori informazioni sui termini utilizzati nella documentazione di API Gateway.

API
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.
Configurazione API
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.
Definizione dell'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.
Chiave API
Un codice passato da un'applicazione client quando chiama un'API. Le chiavi API identificano l'applicazione o il progetto Google Cloud 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.
Auth0
Un servizio che ti consente di definire in che modo gli utenti si autenticano nelle applicazioni. Per ulteriori informazioni, consulta Auth0.
CORS
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.
Firebase Authentication
Servizio di autenticazione di Google che supporta l'accesso degli utenti finali alle applicazioni client utilizzando le credenziali di fornitori di identità federati come Google, Facebook o Twitter. Per saperne di più, consulta la sezione sull'autenticazione Firebase.
Gateway
Un proxy scalabile ad alte prestazioni basato su Envoy che ospita la configurazione 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.
Token ID Google
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.
gRPC
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.
JWT
Il token web JSON è un formato di token di accesso standard aperto da utilizzare nelle intestazioni di autorizzazione HTTP e parametri di ricerca URI. Per informazioni generali, consulta la pagina Introduzione ai token web JSON.
OpenAPI
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.
Documento 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.
Superficie
L'interfaccia pubblica di un'API. L'interfaccia di un'API è costituita dai metodi, nonché dai parametri e dai tipi restituiti utilizzati nei metodi.