Cloud Endpoints es un sistema de gestión de APIs que te ayuda a proteger, monitorizar, analizar y definir cuotas en tus APIs usando la misma infraestructura que Google utiliza para sus propias APIs. Endpoints funciona con el proxy de servicios extensible (ESP) y el proxy de servicios extensible V2 (ESPv2) para proporcionar gestión de APIs. Puedes consultar más información sobre Endpoints, ESP y ESPv2 en Acerca de Endpoints.
Endpoints admite la versión 2 de la especificación de OpenAPI (antes conocida como especificación de Swagger), el estándar del sector para definir APIs REST. Si no conoces la especificación de OpenAPI, consulta la información general sobre OpenAPI.
En esta documentación se explica cómo usar Endpoints con OpenAPI. Para consultar la documentación sobre las otras opciones de Endpoints, consulta Toda la documentación de Endpoints.
Para empezar, te recomendamos que sigas este orden en la documentación:
Para ver las funciones de Endpoints en acción, consulta la guía de inicio rápido de Cloud Endpoints, que usa secuencias de comandos para desplegar una API de ejemplo en el entorno flexible de App Engine.
Ahora debes decidir qué plataforma de computación quieres usar para tu API. Para ayudarte a tomar esa decisión, consulta el artículo Elegir una opción de computación y la sección Plataformas de computación compatibles que se encuentra más abajo.
Una vez que hayas decidido el backend de tu API, sigue un tutorial para la plataforma de computación que prefieras.
Plataformas de computación compatibles
Endpoints para OpenAPI depende de ESP o ESPv2 para la gestión de APIs. ESP y ESPv2 son proyectos de código abierto y están disponibles de las siguientes formas:
- Un contenedor de Artifact Registry.
- Consulte las notas de la versión de ESP para ver la imagen Docker de ESP actual.
- Consulta las notas de la versión de ESPv2 para ver la imagen Docker de ESPv2 actual.
- Código fuente en GitHub.
- Consulta el archivo README del ESP para obtener más información sobre cómo crear un ESP.
- Consulta el archivo README de ESPv2 para obtener más información sobre cómo compilar ESPv2.
Puedes ejecutar el contenedor ESP en lo siguiente:
- Entorno flexible de App Engine
- Compute Engine
- Kubernetes, incluido Google Kubernetes Engine
- Un ordenador con Linux o macOS, u otra plataforma
Puedes ejecutar el contenedor de ESPv2 en lo siguiente:
- App Engine
- Cloud Run Functions
- Cloud Run
- Servicio de Knative
- GKE
- Compute Engine
- Kubernetes
Consulta Acerca de Cloud Endpoints para obtener más información.
En el entorno flexible de App Engine, ESP se despliega automáticamente cuando añades unas líneas al archivo app.yaml. Para obtener más información, consulta el artículo sobre cómo implementar tu API y ESP. ESPv2 no es compatible con el entorno flexible de App Engine.
En el entorno estándar de App Engine de primera generación, debes usar Endpoints Frameworks. Si, en su lugar, implementas el contenedor en una de las opciones de computación anteriores, puedes usar un proxy para cualquiera de las generaciones del tiempo de ejecución estándar de App Engine.