Endpoints is a distributed API management system. It provides an API console, hosting, logging, monitoring, and other features to help you create, share, maintain, and secure your APIs. This page provides an overview of Cloud Endpoints for OpenAPI. For information on other types of API frameworks supported by Endpoints, see All Endpoints docs.
Endpoints is available for use with the distributed Extensible Service Proxy (ESP) or the Extensible Service Proxy V2 Beta (ESPv2 Beta). Each proxy provides support to the platforms described below:
- App Engine flexible (ESP only)
- Google Kubernetes Engine (ESP or ESPv2 Beta)
- Compute Engine (ESP or ESPv2 Beta)
- Kubernetes (ESP or ESPv2 Beta)
- App Engine standard (ESPv2 Beta only)
- Cloud Functions (ESPv2 Beta only)
- Cloud Run (ESPv2 Beta only)
- Cloud Run for Anthos (ESPv2 Beta only)
Endpoints with ESP
Endpoints uses the distributed Extensible Service Proxy (ESP) to provide low latency and high performance for serving even the most demanding APIs. ESP is a service proxy based on NGINX, so you can be confident that it scales as needed to handle simultaneous requests to your API. ESP runs in its own Docker container for better isolation and scalability and is distributed in the Container Registry. You can use it with:
Endpoints with ESPv2 Beta
ESPv2 Beta is an Envoy-based high-performance, scalable proxy that runs in front of an OpenAPI or gRPC API backend. ESPv2 Beta supports version 2 of the OpenAPI Specification and gRPC Specifications. You can use it with:
- Compute Engine
- App Engine Standard environment
- Cloud Functions
- Cloud Run
- Cloud Run for Anthos
Endpoints API management features
Whether you use Endpoints with ESP or ESPv2 Beta, it provides a number of significant API management features to enable you to develop, monitor, and control access to your APIs.
Logs and metrics
Endpoints uses Service Infrastructure to manage APIs and report logs and metrics. Most Google Cloud APIs use this same infrastructure. You can manage and monitor your APIs on the Endpoints Services page in the Google Cloud Console.
Endpoints is optimized for the Docker container environment. You can host your API anywhere Docker is supported so long as it has internet access to Google Cloud.
Developing a REST API with Endpoints for OpenAPI
Endpoints is language independent. You build your API in any language and REST framework that supports API description using an OpenAPI configuration file.
To use Endpoints for OpenAPI, you:
Configure Endpoints: You describe the API surface and configure Endpoints features, such as API keys or authentication rules, in an OpenAPI configuration file.
Deploy the Endpoints configuration: After you define your API in an OpenAPI configuration file, you use the Cloud SDK to deploy it to Service Management, which Endpoints uses to manage your API. Now Endpoints knows all about your API and how to secure it.
Deploy the API Backend: You deploy ESP or ESPv2 Beta and your API backend to a supported Google Cloud backend, such as Compute Engine. ESP coordinates with Endpoints backend services to secure and monitor your API at runtime.
Controlling API access
Endpoints lets you configure your API to require an API key for any call and validates the API key. You can also use the Google Cloud Console to share your API with other developers so they can enable your API and generate API keys to call it.
Authenticating API users
Note that your API server still needs to decide what the authenticated user can do with your API. For more information, see the Google Cloud Auth guide.