Acerca de Cloud Endpoints

Endpoints es un sistema de gestión de APIs distribuido. Ofrece una consola de APIs, alojamiento, registro, monitorización y otras funciones para ayudarte a crear, compartir, mantener y proteger tus APIs. En esta página se ofrece una descripción general de Cloud Endpoints para OpenAPI. Para obtener información sobre otros tipos de frameworks de API compatibles con Endpoints, consulta todos los documentos de Endpoints.

Endpoints se puede usar con el proxy de servicios extensible (ESP) distribuido o con el proxy de servicios extensible V2 (ESPv2). Cada proxy ofrece asistencia para las plataformas que se describen a continuación:

  • Entorno flexible de App Engine (solo ESP)
  • Google Kubernetes Engine (ESP o ESPv2)
  • Compute Engine (ESP o ESPv2)
  • Kubernetes (ESP o ESPv2)
  • Entorno estándar de App Engine (solo ESPv2)
  • Funciones de Cloud Run (solo ESPv2)
  • Cloud Run (solo ESPv2)
  • Servicio de Knative (solo ESPv2)

Endpoints con ESP

Endpoints usa el proxy de servicio extensible (ESP) distribuido para ofrecer una latencia baja y un rendimiento alto al servir incluso las APIs más exigentes. ESP es un proxy de servicio basado en NGINX, por lo que puedes tener la certeza de que se escalará según sea necesario para gestionar las solicitudes simultáneas a tu API. ESP se ejecuta en su propio contenedor Docker para mejorar el aislamiento y la escalabilidad, y se distribuye en Container Registry. Puedes usarlo con:

Endpoints con ESPv2

ESPv2 es un proxy escalable de alto rendimiento basado en Envoy que se ejecuta delante de un backend de API OpenAPI o gRPC. ESPv2 admite la versión 2 de las especificaciones de OpenAPI y gRPC. Puedes usarlo con:

Funciones de gestión de APIs de Endpoints

Tanto si usas Endpoints con ESP como con ESPv2, te ofrece una serie de funciones de gestión de APIs importantes que te permiten desarrollar, monitorizar y controlar el acceso a tus APIs.

Registros y métricas

Endpoints usa Infraestructura de servicios para gestionar las APIs y registrar métricas y registros. La mayoría de las Google Cloud APIs usan esta misma infraestructura. Puedes gestionar y monitorizar tus APIs en la página Servicios de Endpoints de la Google Cloud consola.

Alojamiento de APIs

Endpoints está optimizado para el entorno de contenedores Docker. Puedes alojar tu API en cualquier lugar donde se admita Docker, siempre que tenga acceso a Internet paraGoogle Cloud.

Desarrollar una API REST con Endpoints para OpenAPI

Los endpoints no dependen del idioma. Puedes crear tu API en cualquier lenguaje y framework REST que admita la descripción de APIs mediante un archivo de configuración de OpenAPI.

Para usar Endpoints para OpenAPI, debes hacer lo siguiente:

  • Configurar los endpoints: describe la superficie de la API y configura las funciones de Endpoints, como las claves de API o las reglas de autenticación, en un archivo de configuración de OpenAPI.

  • Despliega la configuración de Endpoints: después de definir tu API en un archivo de configuración OpenAPI, usa la CLI de Google Cloud para desplegarla en Service Management, que es el servicio que usa Endpoints para gestionar tu API. Ahora Endpoints conoce todos los detalles de tu API y sabe cómo protegerla.

  • Despliega el backend de la API: despliega ESP o ESPv2 y el backend de tu API en un Google Cloud backend compatible, como Compute Engine. ESP se coordina con los servicios de backend de Endpoints para proteger y monitorizar tu API en tiempo de ejecución.

Controlar el acceso a la API

Endpoints te permite configurar tu API para que requiera una clave de API para cualquier llamada y valida la clave de API. También puedes usar la Google Cloud consola para compartir tu API con otros desarrolladores para que puedan habilitarla y generar claves de API para llamarla.

Autenticar usuarios de la API

En la mayoría de las llamadas a la API, hay un usuario al otro lado. Aunque las claves de API indican qué aplicación está haciendo una llamada a tu API, el proceso de autenticación determina qué usuario está usando esa aplicación.

Ten en cuenta que tu servidor de API debe decidir qué puede hacer el usuario autenticado con tu API. Para obtener más información, consulta la Google Cloud guía de autenticación.

Siguientes pasos

  • Familiarízate con los pasos de implementación y consulta las funciones de Endpoints en acción con la guía de inicio rápido de Endpoints, que usa secuencias de comandos para implementar una API de ejemplo en un backend flexible de App Engine.

  • Para obtener más información sobre cómo usar Endpoints, consulta uno de los tutoriales.