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 consumare facilmente funzionalità o dati di un'altra applicazione. Definendo punti di ingresso stabili, semplici e ben documentati, le API consentono agli sviluppatori di accedere facilmente alla logica dell'applicazione e riutilizzarla, creata da altri sviluppatori.
Configurazione API: Creato quando carichi una definizione API in API Gateway. Ogni volta che carichi una definizione API, API Gateway crea una nuova configurazione API. Ciò significa che puoi creare una configurazione API, ma non puoi modificarla in seguito. Se in un secondo momento modifichi la definizione API e poi carichi la definizione modificata, crei una nuova configurazione API.
Definizione di API: Una specifica API aperta 2.0 o gRPC utilizzata per creare una configurazione API. La definizione dell'API specifica: l'URL del servizio di backend, il formato dei dati trasmessi a una richiesta, il formato dei dati restituiti dal servizio, il meccanismo di autenticazione utilizzato per controllare l'accesso al servizio e molte altre opzioni.
Chiave API: Un codice trasmesso da un'applicazione client quando chiama un'API. Le chiavi API identificano l'applicazione o il progetto Google Cloud che effettua la chiamata all'API. Consulta Perché e quando utilizzare le chiavi API per ulteriori informazioni sull'utilizzo di una chiave API con l'API API Gateway.
Auth0: Un servizio che consente di definire il modo in cui gli utenti possono eseguire l'autenticazione nelle applicazioni. Vedi Auth0 per ulteriori informazioni.
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 ulteriori informazioni su CORS, consulta la documentazione web di Mozilla Developer Network (MDN) e il documento Fetch Living Standard.
Autenticazione Firebase: Il servizio di autenticazione di Google che supporta l'accesso degli utenti finali per le applicazioni client utilizzando credenziali di provider di identità federate popolari come Google, Facebook o Twitter. Per ulteriori informazioni, consulta Autenticazione Firebase.
Gateway: Un proxy scalabile, ad alte prestazioni e basato su Envoy che ospita la configurazione API di cui è stato eseguito il deployment. La creazione di un gateway crea l'URL rivolto all'esterno che i client API utilizzano 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 JWT (JSON Web Token) che contiene i campi OpenID Connect necessari per identificare un account utente o di 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 su 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: JSON Web Token è un formato di token di accesso standard aperto da utilizzare nelle intestazioni di autorizzazione HTTP e parametri di ricerca URI. Per informazioni generali, vedi Introduzione ai token web JSON.
OpenAPI: L'Open API Initiative è un'iniziativa del 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 client e server. Per ulteriori informazioni, consulta la panoramica di OpenAPI.
Documento OpenAPI: Un file in formato YAML o JSON che usi per descrivere la tua API. Questo file viene denominato anche definizione API. Una volta caricato in API Gateway, il documento OpenAPI viene convertito in una configurazione API.
Piattaforma: L'interfaccia pubblica di un'API. La superficie di un'API è costituita dai metodi, dai parametri e dai tipi restituiti utilizzati nei metodi.