Endpoints è un sistema di gestione delle API distribuito. Offre un Console API, hosting, logging, monitoraggio e altre funzionalità utili creare, condividere, gestire e proteggere le API. Questa pagina fornisce una panoramica Cloud Endpoints per OpenAPI. Per informazioni su altri tipi di framework API supportati Endpoint, vedi Tutti i documenti di Endpoints.
Endpoints è disponibile per l'utilizzo con Extensible Service Proxy (ESP) distribuito o Extensible Service Proxy V2 (ESPv2). Ciascun 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)
- Knative serving (solo ESPv2)
Endpoints con ESP
Endpoints utilizza l'Extensible Service Proxy (ESP) distribuito per offrire bassa latenza e prestazioni elevate per gestire anche i prodotti più esigenti su quelle di livello inferiore. 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 migliorare l'isolamento e la scalabilità distribuiti in Container Registry. Puoi usarlo 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 di Specifica OpenAPI e specifiche gRPC. Puoi usarlo con:
- Ambiente standard di App Engine
- Compute Engine
- Google Kubernetes Engine
- Kubernetes
- Cloud Run
- Knative serving
- Cloud Functions
Funzionalità di gestione dell'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 generare report su log e metriche. Più alta API Google Cloud usano questa stessa infrastruttura. Puoi gestire e monitorare le API nella Servizi endpoint nella 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
Endpoints è indipendente dal linguaggio. Puoi creare l'API in qualsiasi e REST che supporta la descrizione dell'API utilizzando File di configurazione OpenAPI.
Per utilizzare Endpoints per OpenAPI, devi:
Configura endpoint: descrivi l'API. superficie e configurare le funzionalità di Endpoints, come le chiavi API 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 API. Ora Endpoints sa tutto sulla tua API e su come proteggere li annotino.
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. Coordinate ESP con backend 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 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, ogni chiamata corrisponde a un utente. Mentre Chiavi API indica quale app sta effettuando una chiamata alla tua API, autenticazione processo determina quale utente utilizza l'app.
Tieni presente che il server API deve comunque decidere quale utente autenticato con la tua API. Per ulteriori informazioni, consulta Guida di Google Cloud Auth.
Passaggi successivi
Acquisisci familiarità con i passaggi di deployment e visualizza Endpoints le funzionalità in azione Guida rapida per Endpoints, che utilizza gli script per eseguire il deployment di un'API di esempio in un'App Engine backend.
Scopri di più sull'utilizzo di Endpoints: Tutorial.