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 su altri tipi di framework API supportati da Endpoints, vedi Tutti i documenti 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:
- Ambiente flessibile App Engine (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 Extensible Service Proxy (ESP) distribuito per fornire bassa latenza e prestazioni elevate per la gestione anche delle API più esigenti. ESP è un proxy di servizio basato su NGINX, quindi puoi avere la certezza che venga scalato in base alle necessità per gestire le richieste simultanee alla tua API. L'ESP viene eseguito nel proprio container Docker per un migliore isolamento e scalabilità ed è distribuito in Container Registry. Puoi utilizzarlo con:
Endpoints con ESPv2
ESPv2 è un proxy scalabile e ad alte prestazioni basato su Envoy che viene eseguito davanti a un backend API OpenAPI o gRPC. ESPv2 supporta la versione 2 delle specifiche OpenAPI e delle specifiche gRPC. Puoi utilizzarlo con:
- Ambiente standard di App Engine
- Compute Engine
- Google Kubernetes Engine
- Kubernetes
- Cloud Run
- Knative serving
- Cloud Run Functions
Funzionalità di gestione delle API di Endpoints
Indipendentemente dal fatto che utilizzi Endpoints con ESP o ESPv2, offre una serie di importanti funzionalità di gestione delle API che ti consentono di sviluppare, monitorare e controllare l'accesso alle tue API.
Log e metriche
Endpoints utilizza Service Infrastructure per gestire le API e segnalare log e metriche. La maggior parte delle Google Cloud API utilizza la stessa infrastruttura. Puoi gestire e monitorare le tue API nella pagina Servizi Endpoints della Google Cloud console.
Hosting API
Endpoints è ottimizzato per l'ambiente dei container Docker. Puoi ospitare la tua API ovunque sia supportato Docker, purché abbia accesso a internet a Google Cloud.
Sviluppo di un'API REST con Endpoints per OpenAPI
Gli endpoint sono indipendenti dalla lingua. 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 dell'API e configura 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 della tua API e come proteggerla.
Esegui il deployment del backend API: esegui il deployment di ESP o ESPv2 e del backend API in un backend Google Cloud supportato, ad esempio Compute Engine. ESP coordina i servizi di backend di Endpoints per proteggere e monitorare l'API in fase di runtime.
Controllo dell'accesso all'API
Endpoints consente di configurare l'API in modo che richieda una chiave API per qualsiasi chiamata e la convalida. Puoi anche utilizzare la console Google Cloud per condividere la tua API con altri sviluppatori in modo che possano abilitarla e generare chiavi API per chiamarla.
Autenticazione degli utenti API
Per la maggior parte delle chiamate API, c'è un utente all'altro capo della chiamata. Mentre le chiavi API indicano quale app sta chiamando la tua API, il processo 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 Google Cloud guida all'autenticazione.
Passaggi successivi
Familiarizza con i passaggi di deployment e scopri le funzionalità di Endpoints in azione seguendo 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.