Acerca de Cloud Endpoints

Endpoints es un sistema distribuido de administración de API. Proporciona una consola de API, hosting, registro, supervisión y otras características para ayudarte a crear, compartir, mantener y asegurar tus API. En esta página, se brinda una descripción general de Cloud Endpoints para OpenAPI. Si deseas obtener más información sobre otros tipos de marcos de trabajo de API compatibles con Endpoints, consulta Todos los documentos de Endpoints.

Endpoints usa el Proxy de servicio extensible (ESP) distribuido a fin de proporcionar latencia baja y rendimiento alto, y así entregar incluso las API más exigentes. El ESP es un proxy de servicio basado en NGINX, por lo que puedes estar seguro de que posee el escalamiento necesario para controlar solicitudes simultáneas a la API. El ESP se ejecuta en su propio contenedor de Docker con el fin de lograr un mejor aislamiento y mayor escalabilidad. Además, se distribuye en el Container Registry. Puedes usarlo con App Engine Flexible, Google Kubernetes Engine (GKE), Compute Engine o Kubernetes.

Arquitectura de Endpoints

Endpoints usa la Infraestructura de servicios para administrar las API y también informar sobre registros y métricas. La mayoría de las API de Google Cloud Platform (GCP) usan esta misma infraestructura. Puedes administrar y supervisar tus API en la página de Servicios de Endpoints en Google Cloud Platform Console.

Cómo alojar una API

Endpoints está optimizado para el entorno de contenedores de Docker. Puedes alojar tu API en cualquier lugar que sea compatible con Docker, siempre y cuando tenga acceso a Internet para ingresar a GCP.

Sin embargo, Endpoints proporciona un flujo de trabajo optimizado para ejecutar las API en:

  • Compute Engine
  • GKE
  • El entorno flexible de App Engine, que incluye el ESP incorporado

Cómo desarrollar una API de REST con Endpoints para OpenAPI

Endpoints es independiente del lenguaje. Compilas tu API en cualquier marco de trabajo de REST y lenguaje que sea compatible con la descripción de la API mediante el uso de un archivo de configuración de OpenAPI.

A fin de usar Endpoints para OpenAPI, debes hacer lo siguiente:

  • Configurar Endpoints: Describes la superficie de la API y configuras las características de Endpoints, como las claves de API o las reglas de autenticación, en un archivo de configuración de OpenAPI.

  • Implementar la configuración de Endpoints: Luego de que definas tu API en un archivo de configuración de OpenAPI, usa el SDK de Cloud para implementarla en Service Management, que Endpoints utiliza con el fin de administrar la API. Ahora Endpoints sabe todo acerca de la API y cómo protegerla.

  • Implementar el backend de la API: Implementas el ESP y el backend de la API en un backend de GCP compatible, como Compute Engine. El ESP coordina con los servicios de backend de Endpoints para proteger y supervisar la API en el entorno de ejecución.

Cómo controlar el acceso a la API

Endpoints te permite configurar la API a fin de que se solicite una clave de API para cualquier llamada y valida la clave de API. También puedes usar Google Cloud Platform Console para compartir tu API con otros desarrolladores y que estos puedan habilitarla y generar claves de API para llamarla.

Cómo autenticar los usuarios de las API

En la mayoría de las llamadas a la API, hay un usuario en el otro extremo de cada llamada. Mientras que las claves de API indican qué aplicación está haciendo una llamada a la API, el proceso de autenticación determina qué usuario está usando esa aplicación.

Ten en cuenta que tu servidor de API aún necesita decidir qué es lo que el usuario autenticado puede hacer con la API. Para obtener más información, consulta la Guía de autenticación de GCP.

¿Qué sigue?

  • Familiarízate con los pasos de implementación y ve las características de Endpoints en acción por medio de la Guía de inicio rápido para Endpoints, que utiliza secuencias de comandos a fin de implementar una API de muestra a un backend de App Engine Flexible.

  • Para obtener más información sobre Endpoints, realiza uno de los Instructivos.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Cloud Endpoints con OpenAPI
Si necesitas ayuda, visita nuestra página de asistencia.