Implementa las APIs de Cloud Endpoints en API Gateway

Cloud Endpoints es un sistema de administración de APIs que te ayuda a proteger, supervisar, analizar y establecer cuotas en tus APIs. Endpoints usa el proxy de servicio extensible (ESP) o el proxy de servicio extensible V2 (ESPv2) para alojar tus APIs.

Cuando usas extremos, tienes tres opciones para definir tu API:

Desarrolla APIs con API Gateway

Tanto Endpoints como API Gateway admiten las APIs que se describen con la especificación de OpenAPI, OpenAPI 2.0 o OpenAPI 3.x. Si usaste OpenAPI para definir tus APIs de Endpoints, esto significa que también puedes implementarlas en API Gateway.

Implementa especificaciones de OpenAPI de Endpoints en API Gateway

API Gateway admite las mismas opciones y el formato de especificación de OpenAPI que admite Cloud Endpoints para OpenAPI. Esto significa que puedes usar las mismas definiciones de seguridad, cuota y otras de las especificaciones de OpenAPI de Endpoints para definir una API en API Gateway.

La única diferencia entre Endpoints y API Gateway es cómo procesan la propiedad host en la definición de especificación de OpenAPI:

  • En Endpoints, configura la propiedad host en la parte del nombre de host de la URL que se creó cuando implementaste el ESP o el ESPv2, donde ESP o ESPv2 es el servicio que se usó para alojar la API de Endpoints.
  • En API Gateway, omite host o configúralo como el nombre de DNS de la API implementada. Los proveedores de APIs suelen establecerlo en el nombre de DNS cuando comparten la especificación de OpenAPI con sus consumidores de APIs. Sin embargo, API Gateway no aplica el valor de la propiedad host.

Por ejemplo, a continuación, se muestra una parte de una definición de OpenAPI que usa Endpoints para definir una API que permite acceder a un servicio de backend implementado en Cloud Run Functions:

OpenAPI 2.0

swagger: '2.0'
info:
  title: Cloud Endpoints + GCF
  description: Sample API on Cloud Endpoints with a Google Cloud Functions backend
  version: 1.0.0
host: HOST
schemes:
  - https
  ...

OpenAPI 3.x

openapi: 3.0.4
info:
  title: Cloud Endpoints + GCF
  description: Sample API on Cloud Endpoints with a Google Cloud Functions backend
  version: 1.0.0
servers:
- url: https://HOST
  x-google-endpoint: {}
...

Para obtener más información sobre cómo crear la especificación de OpenAPI para la definición de tu API, consulta Descripción general de OpenAPI.

¿Qué sigue?