Endpoints è un sistema di gestione delle API distribuito. Fornisce una console API, hosting, logging, monitoraggio e altre funzionalità per aiutarti a creare, condividere, gestire e proteggere le tue API. Questa pagina fornisce una panoramica di Cloud Endpoints per OpenAPI. Per informazioni sugli altri tipi di framework API supportati dagli endpoint, consulta Tutti la documentazione di Endpoints.
Endpoints è disponibile per l'utilizzo con Extensible Service Proxy (ESP) distribuito o Extensible Service Proxy V2 (ESPv2). Ogni proxy fornisce supporto alle piattaforme descritte di seguito:
- App Engine flessibile (solo ESP)
- Google Kubernetes Engine (ESP o ESPv2)
- Compute Engine (ESP o ESPv2)
- Kubernetes (ESP o ESPv2)
- Standard App Engine (solo ESPv2)
- Cloud Functions (solo ESPv2)
- Cloud Run (solo ESPv2)
- Pubblicazione Knative (solo ESPv2)
Endpoints con ESP
Endpoints utilizza Extensible Service Proxy (ESP) distribuito per fornire bassa latenza e prestazioni elevate per gestire anche le API più esigenti. ESP è un proxy di servizio basato su NGINX, che garantisce la scalabilità in base alle esigenze per gestire richieste simultanee alla tua API. ESP viene eseguito nel proprio container Docker, per migliorare l'isolamento e la scalabilità, ed è distribuito nel Container Registry. Puoi usarlo con:
Endpoints con ESPv2
ESPv2 è un proxy scalabile ad alte prestazioni basato su Envoy che viene eseguito davanti al backend di un'API OpenAPI o gRPC. ESPv2 supporta la versione 2 della specifica OpenAPI e delle specifiche gRPC. Puoi usarlo con:
- Ambiente standard di App Engine
- Compute Engine
- Google Kubernetes Engine
- Kubernetes
- Cloud Run
- Pubblicazione Knative
- Cloud Functions
Funzionalità di gestione dell'API Endpoints
Che tu utilizzi Endpoints con ESP o ESPv2, offre una serie di funzionalità di gestione delle API significative per consentirti di sviluppare, monitorare e controllare l'accesso alle tue API.
Log e metriche
Endpoints utilizza l'infrastruttura di servizi per gestire le API e generare report su log e metriche. La maggior parte delle API Google Cloud utilizza questa stessa infrastruttura. Puoi gestire e monitorare le tue API nella pagina Servizi endpoint della console Google Cloud.
Hosting API
Gli endpoint sono ottimizzati per l'ambiente dei container Docker. Puoi ospitare la tua API ovunque sia supportato Docker, purché abbia accesso a internet Google Cloud.
Sviluppo di un'API REST con Endpoints per OpenAPI
Endpoints è indipendente dal linguaggio. Puoi creare la tua API in qualsiasi linguaggio e framework REST che supporti la descrizione dell'API utilizzando un file di configurazione OpenAPI.
Per utilizzare Endpoints per OpenAPI:
Configura Endpoints: descrivi la superficie API e configuri le funzionalità di Endpoints, come le chiavi API o le regole di autenticazione, in un file di configurazione OpenAPI.
Esegui il deployment della configurazione di Endpoints: dopo aver definito l'API in un file di configurazione OpenAPI, utilizza Google Cloud CLI per eseguirne il deployment in Service Management, che Endpoints utilizza per gestire l'API. Ora Endpoints conosce tutto l'API e sa come proteggerla.
Esegui il deployment del backend dell'API: esegui il deployment di ESP o ESPv2 e del backend dell'API in un backend Google Cloud supportato, ad esempio Compute Engine. ESP si coordina con i servizi di backend di Endpoints per proteggere e monitorare l'API in fase di runtime.
Controllo dell'accesso alle API
Endpoints consente di configurare l'API in modo che richieda una chiave API per qualsiasi chiamata e convalida la chiave API. Puoi anche utilizzare la console Google Cloud per condividere l'API con altri sviluppatori in modo che possano abilitare l'API e generare chiavi API per chiamarla.
Autenticazione degli utenti dell'API
Per la maggior parte delle chiamate API, c'è un utente all'altro capo di ogni chiamata. Mentre le chiavi API indicano quale app sta effettuando una chiamata all'API, il processo di autenticazione determina quale utente sta utilizzando l'app.
Tieni presente che il server API deve comunque decidere che cosa può fare l'utente autenticato con l'API. Per ulteriori informazioni, consulta la guida di Google Cloud Auth.
Passaggi successivi
Acquisisci familiarità con la procedura di deployment e guarda le funzionalità di Endpoints in azione con la Guida rapida per Endpoints, che utilizza gli script per eseguire il deployment di un'API di esempio in un backend di App Engine flessibile.
Scopri di più sull'utilizzo di Endpoints seguendo uno dei tutorial.