Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cloud Endpoints Frameworks est un framework Web pour les environnements d'exécution Python 2.7 et Java 8 standards App Engine.
Cloud Endpoints Frameworks fournit les outils et les bibliothèques requis pour vous permettre de générer des API REST et des bibliothèques clientes pour votre application.
À l'instar d'autres frameworks Web, Endpoints Frameworks est compatible avec les détails de communication de bas niveau des requêtes et réponses HTTP pour votre application. Lorsqu'un client envoie une requête à votre API, Endpoints Frameworks achemine l'URL de la requête vers la fonction ou la méthode de votre code qui traite la requête.
Endpoints Frameworks convertit la valeur d'affichage en JSON et envoie la réponse. Ajoutez des métadonnées à votre code source (en utilisant des annotations en Java et des décorateurs en Python). Les métadonnées définissent la surface des API REST pour votre application.
Dans l'exemple de code, les annotations commencent par le caractère @.
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",)defecho(self,request):output_message=" ".join([request.message]*request.n)returnEchoResponse(message=output_message)
Dans l'exemple de code, les décorateurs commencent par le caractère @.
Avec Endpoints Frameworks, il n'est pas nécessaire de déployer de serveur Web tiers (tel qu'Apache Tomcat ou Gunicorn) avec votre application. Vous annotez ou décorez le code et déployez votre application comme vous le feriez normalement vers l'environnement standard App Engine.
Gestion des API
Le proxy Extensible Service Proxy (ESP) fournit des fonctionnalités de gestion des API pour Cloud Endpoints pour OpenAPI et Cloud Endpoints pour gRPC. ESP s'exécute dans un conteneur avec chaque instance de votre backend.
Étant donné que l'environnement standard App Engine n'acceptait pas les déploiements multiconteneurs lorsque Endpoints Frameworks était en cours de développement, ce dernier ne fait pas appel au proxy ESP. Endpoints Frameworks comprend ainsi une passerelle API intégrée qui fournit des fonctionnalités de gestion des API comparables à celles fournies par ESP pour Cloud Endpoints pour OpenAPI et Cloud Endpoints pour gRPC.
Endpoints Frameworks intercepte toutes les requêtes et effectue les vérifications nécessaires, telles que l'authentification, avant de transmettre ces requêtes au backend de l'API. Lorsque le backend répond, Endpoints Frameworks rassemble et consigne les données de télémétrie. Vous pouvez afficher les métriques de votre API sur la page Services Endpoints de la console Google Cloud .
Vous pouvez utiliser Endpoints Frameworks avec ou sans fonctionnalité de gestion des API. L'utilisation d'Endpoints Frameworks sans fonctionnalité de gestion d'API est offerte gratuitement. La fonctionnalité de gestion des API est facturée conformément à la page de tarification Endpoints.
Limites
Endpoints Frameworks est exclusivement pris en charge par les environnements d'exécution Python 2.7 et Java 8 standard App Engine.
Endpoints Frameworks ne prend pas en charge les environnements d'exécution Node.js, PHP et Go dans l'environnement standard App Engine.
Endpoints Frameworks ne prend pas en charge l'environnement flexible App Engine.
Endpoints Frameworks ne prend pas en charge les fonctions Cloud Run, Compute Engine et Google Kubernetes Engine.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eCloud Endpoints Frameworks is a web framework designed for the App Engine standard Python 2.7 and Java 8 runtime environments, allowing you to generate REST APIs and client libraries.\u003c/p\u003e\n"],["\u003cp\u003eEndpoints Frameworks handles HTTP requests and responses, routing URLs to the appropriate code functions and converting return values to JSON, simplifying API development.\u003c/p\u003e\n"],["\u003cp\u003eUsing annotations in Java and decorators in Python, Endpoints Frameworks lets you define the surface of REST APIs directly within your code without the need for a third-party web server.\u003c/p\u003e\n"],["\u003cp\u003eWhile not using the Extensible Service Proxy (ESP), Endpoints Frameworks provides built-in API management comparable to ESP, including request interception, authentication, and telemetry reporting.\u003c/p\u003e\n"],["\u003cp\u003eEndpoints Frameworks is limited to the App Engine standard Python 2.7 and Java 8 environments and does not support Node.js, PHP, Go, the App Engine flexible environment, Cloud Run, Compute Engine, or Google Kubernetes Engine.\u003c/p\u003e\n"]]],[],null,["# Cloud Endpoints Frameworks is a [web\nframework](https://wikipedia.org/wiki/Web_framework) for the App Engine\nstandard [Python 2.7 and Java 8 runtime\nenvironments](/appengine/docs/standard/runtimes).\nCloud Endpoints Frameworks provides the tools and libraries that allow you to\ngenerate REST APIs and client libraries for your application.\n| **Note:** Endpoints Frameworks doesn't support the PHP, Go, or Node.js runtimes.\n\nLike other web frameworks, Endpoints Frameworks handles the low-level\ncommunication details of HTTP requests and responses for your application. When\na client sends a request to your API, Endpoints Frameworks routes the\nrequest's URL to the function or method in your code that processes the request.\nEndpoints Frameworks converts the return value to JSON and sends the\nresponse. You add metadata (by using annotations in Java and decorators in\nPython) to your source code. The metadata defines the\n[surface](/endpoints/docs/frameworks/glossary#surface) of the REST APIs for your\napplication. \n\n### Java\n\n @ApiMethod(name = \"echo\")\n public Message echo(Message message, @Named(\"n\") @Nullable Integer n) {\n return doEcho(message, n);\n }\n\nIn the example code, the\n[annotations](/endpoints/docs/frameworks/java/annotate-code) begin with\nthe `@` character.\n\n### Python\n\n @endpoints.method(\n # This method takes a ResourceContainer defined above.\n ECHO_RESOURCE,\n # This method returns an Echo message.\n EchoResponse,\n path=\"echo\",\n http_method=\"POST\",\n name=\"echo\",\n )\n def echo(self, request):\n output_message = \" \".join([request.message] * request.n)\n return EchoResponse(message=output_message)\n\nIn the example code, the\n[decorators](/endpoints/docs/frameworks/python/create_api) begin with\nthe `@` character.\n\nWith Endpoints Frameworks, you don't have to deploy a third-party web\nserver (such as Apache Tomcat or Gunicorn) with your application. You annotate\nor decorate the code and deploy your application as you normally would to the\n[App Engine standard environment](/appengine/docs/standard).\n\nAPI management\n--------------\n\nThe [Extensible Service Proxy\n(ESP)](/endpoints/docs/frameworks/glossary#extensible_service_proxy)\nprovides API management features for Endpoints for OpenAPI and\nEndpoints for gRPC. ESP runs in a container\nalongside each instance of your backend.\n\n\nBecause the App Engine standard environment didn't support\nmulti-container deployments when Endpoints Frameworks was\nunder development, Endpoints Frameworks doesn't use\nESP. Instead, Endpoints Frameworks includes a built-in\n[API gateway](https://wikipedia.org/wiki/API_management)\nthat provides API management features that are comparable to the\nfeatures that ESP provides for Endpoints for OpenAPI and\nEndpoints for gRPC.\n\n\u003cbr /\u003e\n\nEndpoints Frameworks intercepts all requests and performs any\nnecessary checks (such as authentication) before forwarding the request to the\nAPI backend. When the backend responds, Endpoints Frameworks gathers\nand reports telemetry. You can view metrics for your API on the **Endpoints\nServices** page in the Google Cloud console.\n\nYou can use Endpoints Frameworks with or without API management\nfunctionality. Use of Endpoints Frameworks without API management\nfunctionality is offered at no charge. API management functionality is charged\naccording to the [Endpoints pricing\npage](/endpoints/pricing).\n\nLimitations\n-----------\n\n- Endpoints Frameworks is supported only on the App Engine standard Python 2.7 and Java 8 runtime environments.\n- Endpoints Frameworks doesn't support the Node.js, PHP, and Go runtime environments on the App Engine standard environment.\n- Endpoints Frameworks doesn't support the App Engine flexible environment.\n- Endpoints Frameworks doesn't support Cloud Run functions, Compute Engine, and Google Kubernetes Engine.\n\nWhat's next\n-----------\n\n- To learn more about the differences between ESP and\n Endpoints Frameworks, see [Comparing Extensible Service Proxy and\n Endpoints Frameworks](/endpoints/docs/frameworks/frameworks-extensible-service-proxy#endpoints_frameworks).\n\n- For information on the language-specific libraries and tools, see the following:\n\n - [About Endpoints Frameworks for\n Java](/endpoints/docs/frameworks/java/about-cloud-endpoints-frameworks)\n - [About Endpoints Frameworks for\n Python](/endpoints/docs/frameworks/python/about-cloud-endpoints-frameworks)\n- To learn how to configure, deploy, and send requests to a sample API, see the\n following:\n\n - [Getting started with Endpoints Frameworks for Java](/endpoints/docs/frameworks/java/get-started-frameworks-java)\n - [Getting started with Endpoints Frameworks for Python](/endpoints/docs/frameworks/python/get-started-frameworks-python)"]]