Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Cloud Endpoints è un sistema di gestione delle API che ti aiuta a proteggere, monitorare, analizzare e impostare quote per le tue API utilizzando la stessa infrastruttura utilizzata da Google per le proprie API. Endpoints funziona con Extensible Service Proxy (ESP) ed Extensible Service Proxy V2 (ESPv2) per fornire la gestione delle API. Puoi scoprire di più su Endpoints, ESP ed ESPv2 in Informazioni su Endpoints.
Endpoints supporta la versione 2 della specifica OpenAPI (in precedenza nota come specifica Swagger), lo standard di settore per la definizione delle API REST. Se non hai familiarità con la specifica OpenAPI, consulta la panoramica di OpenAPI.
Questo set di documentazione mostra come utilizzare Endpoints con OpenAPI. Per la documentazione sulle altre opzioni di Endpoints, consulta la pagina Tutti i documenti di Endpoints.
Per iniziare, ti consigliamo di seguire il seguente percorso nella documentazione:
Per vedere le funzionalità di Endpoints in azione, consulta la guida rapida di Cloud Endpoints, che utilizza script per eseguire il deployment di un'API di esempio nell'ambiente flessibile di App Engine.
Dopo aver scelto il backend per la tua API, segui un
tutorial per la piattaforma di calcolo che preferisci.
Piattaforme di calcolo supportate
Endpoints per OpenAPI dipende da ESP o ESPv2 per la gestione delle API. Sia ESP che ESPv2 sono progetti open source e sono disponibili nei seguenti modi:
Per l'ambiente standard di App Engine di 1ª generazione,
devi utilizzare i Framework Endpoints. Se invece esegui il deployment del contenitore in una delle opzioni di calcolo sopra indicate, puoi eseguire il proxy per entrambe le generazioni del runtime standard di App Engine.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eCloud Endpoints is an API management system that utilizes the Extensible Service Proxy (ESP) and Extensible Service Proxy V2 (ESPv2) to help secure, monitor, analyze, and set quotas on APIs.\u003c/p\u003e\n"],["\u003cp\u003eEndpoints supports version 2 of the OpenAPI Specification, the industry standard for defining REST APIs.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation recommends starting with the Quickstart to see Endpoints in action, then choosing a compute platform, followed by a tutorial for that platform.\u003c/p\u003e\n"],["\u003cp\u003eESP and ESPv2, which are open source, can be run in various environments including App Engine, Compute Engine, Kubernetes, and locally.\u003c/p\u003e\n"],["\u003cp\u003eWhile ESP is automatically deployed on the App Engine flexible environment, ESPv2 is not supported there, and the App Engine standard environment requires Endpoints Frameworks instead.\u003c/p\u003e\n"]]],[],null,["# Cloud Endpoints for OpenAPI\n\nCloud Endpoints is an API management system that helps you secure, monitor,\nanalyze, and set quotas on your APIs using the same infrastructure Google uses\nfor its own APIs. Endpoints works with the [Extensible Service\nProxy (ESP)](/endpoints/docs/openapi/glossary#extensible_service_proxy) and the [Extensible Service Proxy V2](/endpoints/docs/openapi/glossary#extensible_service_proxy_v2) (ESPv2) to\nprovide API management. You can find out more about Endpoints, ESP, and ESPv2 in [About\nEndpoints](/endpoints/docs/openapi/about-cloud-endpoints).\n\nEndpoints supports version 2 of the\n[OpenAPI Specification](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md)\n(formerly known as the Swagger spec)---the industry standard for defining REST\nAPIs. If you are unfamiliar with the OpenAPI Specification, see\n[OpenAPI Overview](/endpoints/docs/openapi/openapi-overview).\n\nThis documentation set shows you how to use Endpoints with OpenAPI. For\ndocumentation on the other Endpoints options, see\n[All Endpoints Docs](/endpoints/docs).\n\nTo get started, we recommend the following path through the documentation:\n\n1. To see Endpoints features in action, do the [Quickstart for\n Cloud Endpoints](/endpoints/docs/deploy-api), which uses scripts to\n deploy a sample API to the App Engine flexible environment.\n\n2. Now you need to decide which compute platform you want to use for your API.\n To help you make that decision,\n see [Choosing a Computing Option](/docs/choosing-a-compute-option),\n and see the [Supported compute platforms](#supported_compute_platforms)\n section below.\n\n3. After you have decided on the backend for your API, walk through a\n [tutorial](/endpoints/docs/openapi/tutorials) for your preferred\n compute platform.\n\nSupported compute platforms\n---------------------------\n\nEndpoints for OpenAPI depends on either ESP or ESPv2 for API management. Both ESP and ESPv2 are Open Source projects and are available to you in the following ways:\n\n- A container in Artifact Registry.\n - See the [ESP release notes](https://github.com/cloudendpoints/esp/releases) for the current ESP Docker image.\n - See the [ESPv2 release notes](https:/github.com/GoogleCloudPlatform/esp-v2/releases) for the current ESPv2 Docker image.\n- Source code in GitHub.\n - See the [ESP README](https://github.com/cloudendpoints/esp/blob/master/README.md) for details on building ESP.\n - See the [ESPv2 README](https://github.com/GoogleCloudPlatform/esp-v2/blob/master/README.md) for details on building ESPv2.\n\nYou can run the ESP container on the following:\n\n- App Engine flexible environment\n- Compute Engine\n- Kubernetes, including Google Kubernetes Engine\n- A [Linux or macOS computer or another platform](/endpoints/docs/openapi/running-esp-localdev)\n\nYou can run the ESPv2 container on the following:\n\n- App Engine\n- Cloud Run functions\n- Cloud Run\n- Knative serving\n- GKE\n- Compute Engine\n- Kubernetes\n\nSee [About Cloud Endpoints](/endpoints/docs/openapi/about-cloud-endpoints) for more.\n\nOn the [App Engine flexible environment](/appengine/docs/flexible), ESP is\nautomatically deployed for you when you add a few lines to your\n[`app.yaml`](/appengine/docs/flexible/nodejs/reference/app-yaml) file. For more\ninformation, see [Deploying your API and\nESP](/endpoints/docs/openapi/deploy-api-backend#deploying_your_api_and_esp). ESPv2 does not support App Engine flexible environment.\n\nFor the [App Engine standard generation 1 environment](/appengine/docs/standard),\nyou must use [Endpoints\nFrameworks](/endpoints/docs/frameworks/about-cloud-endpoints-frameworks). If you\ninstead deploy the container to one of the compute options above, you can proxy\nto either generation of App Engine standard runtime."]]