Cloud Endpoints Frameworks

Cloud Endpoints Frameworks es un framework web para los entornos de ejecución estándar de Python 2.7 y Java 8 de App Engine. Cloud Endpoints Frameworks proporciona las herramientas y las bibliotecas que te permiten generar APIs REST y bibliotecas de cliente para tu aplicación.

Al igual que otros frameworks web, Endpoints Frameworks gestiona los detalles de comunicación de bajo nivel de las solicitudes y respuestas HTTP de tu aplicación. Cuando un cliente envía una solicitud a tu API, Endpoints Frameworks dirige la URL de la solicitud a la función o el método de tu código que procesa la solicitud. Endpoints Frameworks convierte el valor devuelto en JSON y envía la respuesta. Añade metadatos (mediante anotaciones en Java y decoradores en Python) al código fuente. Los metadatos definen la superficie de las APIs REST de tu aplicación.

Java

@ApiMethod(name = "echo")
public Message echo(Message message, @Named("n") @Nullable Integer n) {
  return doEcho(message, n);
}

En el código de ejemplo, las anotaciones empiezan con el carácter @.

Python

@endpoints.method(
    # This method takes a ResourceContainer defined above.
    ECHO_RESOURCE,
    # This method returns an Echo message.
    EchoResponse,
    path="echo",
    http_method="POST",
    name="echo",
)
def echo(self, request):
    output_message = " ".join([request.message] * request.n)
    return EchoResponse(message=output_message)

En el código de ejemplo, los decoradores empiezan por el carácter @.

Con Endpoints Frameworks, no tienes que desplegar un servidor web de terceros (como Apache Tomcat o Gunicorn) con tu aplicación. Anota o decora el código y despliega la aplicación como lo harías normalmente en el entorno estándar de App Engine.

Gestión de APIs

El proxy de servicio extensible (ESP) proporciona funciones de gestión de APIs para Endpoints para OpenAPI y Endpoints para gRPC. ESP se ejecuta en un contenedor junto con cada instancia de tu backend.

Como el entorno estándar de App Engine no admitía implementaciones de varios contenedores cuando se estaba desarrollando Endpoints Frameworks, este no usa ESP. En su lugar, Endpoints Frameworks incluye una pasarela de APIs integrada que proporciona funciones de gestión de APIs comparables a las que ofrece ESP para Endpoints para OpenAPI y Endpoints para gRPC.

Endpoints Frameworks intercepta todas las solicitudes y realiza las comprobaciones necesarias (como la autenticación) antes de reenviar la solicitud al backend de la API. Cuando el backend responde, Endpoints Frameworks recoge y registra telemetría. Puedes ver las métricas de tu API en la página Servicios de Endpoints de la consola de Google Cloud .

Puedes usar Endpoints Frameworks con o sin la función de gestión de APIs. El uso de Endpoints Frameworks sin la función de gestión de APIs no tiene coste. La funcionalidad de gestión de APIs se cobra según la página de precios de Endpoints.

Limitaciones

  • Endpoints Frameworks solo se admite en los entornos de ejecución estándar de Python 2.7 y Java 8 de App Engine.
  • Endpoints Frameworks no es compatible con los entornos de ejecución de Node.js, PHP y Go en el entorno estándar de App Engine.
  • Endpoints Frameworks no admite el entorno flexible de App Engine.
  • Endpoints Frameworks no es compatible con las funciones de Cloud Run, Compute Engine y Google Kubernetes Engine.

Siguientes pasos