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 funciones para ayudarte a crear, compartir, mantener y proteger tus API. En esta página, se proporciona una descripción general de Cloud Endpoints para OpenAPI. Si quieres obtener 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 baja latencia 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 quedarte tranquilo de que se escala según sea necesario para controlar solicitudes simultáneas a tu API. El ESP se ejecuta en su propio contenedor de Docker con el fin de lograr un mejor aislamiento y escalabilidad, y se distribuye en Container Registry. Puedes usarlo con el entorno flexible de App Engine, 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 usan esta misma infraestructura. Puedes administrar y supervisar tus API en la página Servicios de Endpoints en Google Cloud Console.

Aloja 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 Google Cloud.

Sin embargo, Endpoints proporciona un flujo de trabajo optimizado para ejecutar las API en lo que se menciona a continuación:

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

Desarrolla una API de REST con Endpoints para OpenAPI

Endpoints es independiente del lenguaje. Puedes compilar 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: puedes escribir la superficie de la API y configurar 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 definir tu API en un archivo de configuración de OpenAPI, usa el SDK de Cloud para implementarla en Service Management, que Endpoints usa con el fin de administrar la API. Ahora, en Endpoints, se cuenta con toda la información acerca de tu API y cómo protegerla.

  • Implementar el backend de la API: Implementa el ESP y el backend de tu API en un backend de Google Cloud compatible, como Compute Engine. El ESP se coordina con los servicios de backend de Endpoints para que se proteja y supervise la API en el entorno de ejecución.

Controla 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 Console para compartir tu API con otros desarrolladores a fin de que puedan habilitar tu API y generar claves de API para llamarla.

Autentica 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é app hace una llamada a la API, el proceso de autenticación determina qué usuario usa esa app.

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 Google Cloud.

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 usa secuencias de comandos a fin de implementar una API de muestra en un backend del entorno flexible de App Engine.

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