O Cloud Endpoints Frameworks é um framework da Web (em inglês) para os ambientes de execução Python 2.7 e Java 8 no ambiente padrão do App Engine. Ele oferece as ferramentas e bibliotecas para você gerar APIs REST e bibliotecas de cliente do aplicativo.
Como outros frameworks da Web, o Endpoints Frameworks processa os detalhes de comunicação de baixo nível das solicitações e respostas HTTP do aplicativo. Quando um cliente envia uma solicitação para sua API, o Endpoints Frameworks encaminha o URL da solicitação para a função ou método em seu código que processa a solicitação. O Endpoints Frameworks converte o valor de retorno em JSON e envia a resposta. Adicione metadados ao código-fonte usando anotações em Java e decoradores em Python. Os metadados definem a superfície das APIs REST do aplicativo.
Java
No código de exemplo, as anotações começam com o caractere @
.
Python
No código de exemplo, os decoradores começam com o caractere @
.
Com o Endpoints Frameworks, não é preciso implantar um servidor da Web de terceiros como o Apache Tomcat ou o Gunicorn com o aplicativo. Anote ou decore o código e implante o aplicativo da mesma maneira que você faria no ambiente padrão do App Engine.
Gerenciamento de APIs
O Extensible Service Proxy (ESP) oferece recursos de gerenciamento da API ao Endpoints para OpenAPI e gRPC. O ESP é executado em um contêiner com cada instância do back-end.
Como o ambiente padrão do App Engine não era compatível com implantações de vários contêineres quando o Endpoints Frameworks estava em desenvolvimento, o Endpoints Frameworks não usa o ESP. Em vez disso, ele inclui uma gateway de API integrada que oferece recursos de gerenciamento de API comparáveis aos recursos fornecidos pelo ESP para Endpoints para OpenAPI e Endpoints para gRPC.
O Endpoints Frameworks intercepta todas as solicitações e executa as verificações necessárias, como a autenticação, antes de encaminhar a solicitação ao back-end da API. Quando o back-end responde, o Endpoints Frameworks coleta e relata a telemetria. É possível conferir as métricas da API na página Endpoints Serviços no console do Google Cloud.
É possível usar o Endpoints Frameworks com ou sem a funcionalidade de gerenciamento da API. O uso sem esse recurso é gratuito. A funcionalidade de gerenciamento da API é cobrada de acordo com a página de preços do Endpoints.
Limitações
- O Endpoints Frameworks é compatível apenas com os ambientes de execução Python 2.7 e Java 8 padrão do App Engine.
- O Endpoints Frameworks não é compatível com os ambientes de execução do Node.js, PHP e Go no ambiente padrão do App Engine.
- O Endpoints Frameworks não é compatível com o ambiente flexível do App Engine.
- O Endpoints Frameworks não é compatível com as funções do Cloud Run. Compute Engine e Google Kubernetes Engine.
A seguir
Para mais informações sobre as diferenças entre o ESP e o Endpoints Frameworks, consulte Comparação entre o Extensible Service Proxy e o Endpoints Frameworks.
Para mais informações sobre as bibliotecas e as ferramentas específicas da linguagem, consulte:
Para saber como configurar, implantar e enviar solicitações a uma amostra de API, consulte: