Endpoints è un sistema di gestione 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 Cloud Endpoints per OpenAPI. Per informazioni su altri tipi di framework API supportati da Endpoints, consulta la documentazione di tutti gli endpoint.
Endpoints è disponibile per l'utilizzo con Extensible Service Proxy (ESP) distribuito o Extensible Service Proxy V2 (ESPv2). Ogni proxy fornisce assistenza 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)
- App Engine standard (solo ESPv2)
- Funzioni Cloud Run (solo ESPv2)
- Cloud Run (solo ESPv2)
- Knative serving (solo ESPv2)
Endpoints con ESP
Endpoints utilizza l'Extensible Service Proxy (ESP) distribuito per fornire bassa latenza e alte prestazioni per l'erogazione anche delle API più esigenti. ESP è un proxy di servizio basato NGINX, in questo modo hai la certezza che scala in base alle esigenze per gestire richieste simultanee alla tua API. ESP viene eseguito nel proprio container Docker per una maggiore isolamento e scalabilità e viene distribuito in Container Registry. Puoi utilizzarlo con:
Endpoints con ESPv2
ESPv2 è un servizio basato su Envoy proxy scalabile ad alte prestazioni, eseguito davanti a un backend OpenAPI o gRPC API. 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
- Knative serving
- Funzioni Cloud Run
Funzionalità di gestione delle API Endpoints
Sia che utilizzi Endpoints con ESP o ESPv2, fornisce una serie di importanti funzionalità di gestione delle API per consentirti di sviluppare, monitorare e controllare l'accesso alle tue API.
Log e metriche
Endpoint utilizza Infrastruttura di servizi per gestire le API e i log e le metriche dei report. Più alta API Google Cloud usano questa stessa infrastruttura. Puoi gestire e monitorare le tue API nella pagina Servizi Endpoints della console Google Cloud.
Hosting API
Endpoints è ottimizzato per l'ambiente container Docker. Tu puoi ospitare la tua API ovunque sia supportato Docker, purché disponga dell'accesso a internet in Google Cloud.
Sviluppo di un'API REST con Endpoints per OpenAPI
Gli endpoint sono indipendenti dalla lingua. Puoi creare l'API in qualsiasi e REST che supporta la descrizione dell'API utilizzando File di configurazione OpenAPI.
Per utilizzare Endpoints per OpenAPI:
Configura Endpoints: descrivi l'interfaccia dell'API e configura le funzionalità di Endpoints, ad esempio le chiavi API o le regole di autenticazione, in un file di configurazione OpenAPI.
Esegui il deployment della configurazione di Endpoints: dopo aver definito in un file di configurazione OpenAPI, per eseguirne il deployment devi utilizzare Google Cloud CLI a Service Management, che Endpoints utilizza per gestire tramite Google Cloud CLI o tramite l'API Compute Engine. Ora Endpoints conosce tutto della tua API e su come proteggerla.
Esegui il deployment del backend delle API: esegui il deployment di ESP o ESPv2 e della tua API. a un backend Google Cloud supportato, come Compute Engine. ESP si coordina con i servizi di backend di Endpoints per proteggere e monitorare l'API in fase di esecuzione.
Controllo dell'accesso all'API
Endpoints ti consente di configurare l'API in modo che richieda una chiave API per qualsiasi chiamata e convalidi la chiave API. Puoi anche utilizzare la console Google Cloud condividere la tua API con altri sviluppatori in modo che abilitare l'API e generare chiavi API per chiamarla.
Autenticazione degli utenti dell'API
Per la maggior parte delle chiamate API, all'altro capo di ogni chiamata c'è un utente. Sebbene le chiavi API indichino quale app sta eseguendo una chiamata alla tua API, la procedura di autenticazione determina quale utente sta utilizzando l'app.
Tieni presente che il server API deve comunque decidere cosa può fare l'utente autenticato con la tua API. Per ulteriori informazioni, consulta la guida di Google Cloud Auth.
Passaggi successivi
Acquisisci familiarità con i passaggi di deployment e prova le funzionalità di Endpoints con la guida rapida per Endpoints, che utilizza script per eseguire il deployment di un'API di esempio in un backend flessibile di App Engine.
Scopri di più sull'utilizzo di Endpoints seguendo uno dei tutorial.