Un proxy API Apigee ha due endpoint: un endpoint proxy e un endpoint di destinazione. L'endpoint proxy è l'interfaccia client.
Riceve richieste dai client e
invia risposte ai client.
L'endpoint di destinazione è l'interfaccia del producer API. Comunica da Apigee a un producer di API, ad esempio un servizio o un'API di backend. Per saperne di più sugli endpoint, consulta Che cos'è un proxy API?
In questo passaggio, modificherai l'endpoint di destinazione del proxy API in https://mocktarget.apigee.net/xml, una risorsa che
restituisce dati XML di test. Dopo aver apportato la modifica, esegui nuovamente il deployment e testa il proxy API rivisto.
Apigee nella console Cloud
Nella console Google Cloud , vai alla pagina Sviluppo proxy > Proxy API.
Nel riquadro a sinistra della visualizzazione Sviluppa, puoi:
Cerca il testo nel proxy nel campo Cerca proxy.
Aggiungi nuove norme.
Aggiungi endpoint proxy e di destinazione.
Aggiungi altre risorse.
Se non vuoi visualizzare il riquadro a sinistra, puoi comprimerlo facendo clic sul pulsante
Chiudi .
Il riquadro a destra della visualizzazione Sviluppa mostra gli editor visivi e di testo
per il proxy:
L'editor visivo fornisce una visualizzazione grafica
del flusso di richiesta e risposta.
L'editor di testo ti consente di modificare l'XML per il proxy o la destinazione.
Note:
Puoi fare clic e trascinare il divisore tra i due editor verso l'alto o verso il basso per espandere
l'area di visualizzazione di uno dei due editor.
Puoi espandere l'area di visualizzazione
dell'editor visuale facendo clic sul pulsante di attivazione/disattivazione
sul lato destro dell'editor di testo, che chiude il riquadro dell'editor di testo. Fai di nuovo clic sul pulsante
per riaprire il riquadro dell'editor di testo.
Modificare l'endpoint di destinazione
Per modificare l'endpoint di destinazione del proxy:
Nel riquadro Revisione proxy, seleziona Endpoint di destinazione > predefinito.
Viene visualizzato un diagramma dell'endpoint di destinazione nell'editor visivo:
Sotto l'editor visuale, il codice XML per l'endpoint di destinazione viene visualizzato nell'editor di testo:
Nell'editor di testo, modifica <URL> in
https://mocktarget.apigee.net/xml. Aggiungi "/xml" all'URL esistente.
Seleziona il proxy dall'elenco per visualizzare i dettagli del proxy API. Se non vedi il tuo proxy nell'elenco, assicurati di aver selezionato l'organizzazione corretta, come descritto in Passare da un'organizzazione all'altra.
Fai clic sulla scheda Sviluppa:
Viene visualizzato l'editor proxy API. L'editor proxy ti consente di visualizzare la struttura del tuo
proxy API e configurarne il flusso. Un flusso è semplicemente il percorso passo passo che una richiesta proxy API intraprende
attraverso la piattaforma Apigee. Altri tutorial tratteranno il concetto di
flussi.)
Nel riquadro Navigator, seleziona Target Endpoints >
default > PreFlow:
Apigee mostra le impostazioni dell'endpoint nel riquadro Codice:
Per salvare le modifiche alla configurazione del proxy, fai clic sul pulsante Salva.
Apigee salva le modifiche in una nuova revisione del proxy.
Per eseguire il deployment della nuova revisione, seleziona Esegui il deployment in: test e fai clic su Esegui il deployment 2.
Nella finestra di dialogo di conferma, fai clic su Implementa.
Se si verifica un errore, Apigee salva le modifiche, ma non esegue il deployment del proxy. In caso di errore:
Correggi la configurazione del proxy. Apigee potrebbe fornire indicazioni sulla sintassi come popup.
Esegui manualmente il deployment delle modifiche nell'ambiente test facendo clic su
Deployment > test se Apigee non lo esegue automaticamente.
Puoi verificare se la revisione del proxy è stata implementata correttamente visualizzando lo stato della revisione dell'implementazione accanto al menu a discesa Implementa. Ad esempio:
Testa il proxy
Per testare la revisione del proxy API, chiamalo come hai fatto in
Chiamare un proxy API.
Questa volta, l'endpoint mocktarget restituisce XML nel corpo della risposta:
[[["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-05 UTC."],[[["\u003cp\u003eThis page details how to modify an Apigee API proxy's target endpoint to interact with a resource returning XML data, applicable to both Apigee and Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves accessing the Apigee UI, either through the Google Cloud console or the classic interface, and navigating to the API proxy editor to adjust the target endpoint settings.\u003c/p\u003e\n"],["\u003cp\u003eThe target endpoint URL is updated to \u003ccode\u003ehttps://mocktarget.apigee.net/xml\u003c/code\u003e, which directs the proxy to a resource providing test XML data.\u003c/p\u003e\n"],["\u003cp\u003eAfter updating the URL in the visual or text editor, the changes must be saved as a new revision and then deployed to the appropriate environment for testing.\u003c/p\u003e\n"],["\u003cp\u003eOnce the API proxy's target endpoint has been updated, you can then test it to confirm it now returns an XML response.\u003c/p\u003e\n"]]],[],null,["# Step 4: Change the target endpoint\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nAn Apigee API proxy has two endpoints: a proxy endpoint and a target endpoint. The proxy endpoint is the client interface.\nIt receives requests from clients and\nsends responses back to clients.\nThe target endpoint is the API producer interface. It communicates from Apigee to an API producer, such as a backend\nservice or API. To learn more about endpoints, see [What is an API proxy?](/apigee/docs/api-platform/fundamentals/understanding-apis-and-api-proxies#whatisanapiproxy)\n\nIn this step, you will change the API proxy's target endpoint to `https://mocktarget.apigee.net/xml`, a resource that\nreturns test XML data. After making the change, you will redeploy and test the revised API proxy. \n\n### Apigee in Cloud console\n\n1. In the Google Cloud console, go to the **Proxy development \\\u003e API proxies** page.\n\n [Go to API proxies](https://console.cloud.google.com/apigee/proxies)\n2. Make sure the same Google Cloud project where you created the API proxy is selected from the dropdown at the top of the page.\n3. In the proxies table, select the proxy **myproxy** , which you created in [Step 1: Create an API proxy](/apigee/docs/api-platform/get-started/create-proxy).\n4. Click the **Develop** tab.\n\n### Explore the Develop view\n\nIn the left-hand pane of the **Develop** view, you can:\n\n- Search for text in the proxy in the **Search proxy** field.\n- Add new policies.\n- Add proxy and target endpoints.\n- Add other resources.\n\nIf you don't want to view the left-hand pane, you can collapse it by clicking the\nclose button .\n\nThe right-hand pane of the **Develop** view displays the visual and text editors\nfor the proxy:\n\n- The visual editor provides a graphical view of the request and response flow.\n- The text editor lets you edit the XML for the proxy or target.\n\n**Notes:**\n\n- You can click and drag the divider between the two editors up or down to expand the display area of either editor.\n- You can expand the display area of the visual editor by clicking the toggle button on the right side of the text editor, which closes the text editor pane. Click the toggle button again to re-open the text editor pane.\n\n### Change the target endpoint\n\nTo change the target endpoint of the proxy:\n\n1. In the **Proxy revision** pane, select **Target Endpoints \\\u003e default** .\n\n This displays a diagram of the target endpoint in the visual editor:\n\n Below the visual editor, the XML code for the target endpoint is displayed in the text editor:\n\n2. In the text editor, change the `\u003cURL\u003e` to\n `https://mocktarget.apigee.net`**/xml**. (Append \"/xml\" to the existing URL.)\n\n The new URL is shown below: \n\n ```text\n ...\n \u003cHTTPTargetConnection\u003e\n \u003cProperties/\u003e\n \u003cURL\u003ehttps://mocktarget.apigee.net/xml\u003c/URL\u003e\n \u003c/HTTPTargetConnection\u003e\n ...\n ```\n3. Click the arrow next to **Save** at the top right of the Proxy Editor, and select **Save as new revision**.\n4. To deploy your changes, click **Deploy**.\n5. In the **Deploy** dialog, select the revision and environment in which to deploy, and click **Deploy**.\n\n### Classic Apigee UI\n\nTo change your proxy's target endpoint:\n\n1. Sign in to the [Apigee UI](https://apigee.google.com).\n2. Select **Develop \\\u003e API Proxies**.\n3. Select your proxy from the list to display the API proxy details. If you don't see your proxy in the list, be sure that you selected the right organization, as described in [Switching between your organizations](/apigee/docs/api-platform/get-started/switch-org).\n4. Click the **Develop** tab:\n\n This takes you to the API Proxy Editor. The Proxy Editor lets you see the structure of your\n API proxy and configure its flow. (A flow is just the stepwise path an API proxy request takes\n through the Apigee platform. Other tutorials will cover the concept of\n *flows*.)\n5. In the **Navigator** pane, select **Target Endpoints \\\u003e\n default \\\u003e PreFlow** :\n\n Apigee displays the endpoint settings in the **Code** pane: \n\n ```text\n \u003cTargetEndpoint name=\"default\"\u003e\n \u003cDescription/\u003e\n \u003cFaultRules/\u003e\n \u003cPreFlow name=\"PreFlow\"\u003e\n \u003cRequest/\u003e\n \u003cResponse/\u003e\n \u003c/PreFlow\u003e\n \u003cPostFlow name=\"PostFlow\"\u003e\n \u003cRequest/\u003e\n \u003cResponse/\u003e\n \u003c/PostFlow\u003e\n \u003cFlows/\u003e\n \u003cHTTPTargetConnection\u003e\n \u003cProperties/\u003e\n \u003cURL\u003ehttps://mocktarget.apigee.net\u003c/URL\u003e\n \u003c/HTTPTargetConnection\u003e\n \u003c/TargetEndpoint\u003e\n ```\n\n The target endpoint is defined by the `\u003cHTTPTargetConnection\u003e`\n element.\n6. Change the URL to `\"https://mocktarget.apigee.net`**/xml**`\"`. (Append \"/xml\"\n to the existing URL.)\n\n The new URL returns a small block of XML in the body of the response.\n\n Your endpoint configuration should now look like the following: \n\n ```text\n ...\n \u003cHTTPTargetConnection\u003e\n \u003cProperties/\u003e\n \u003cURL\u003ehttps://mocktarget.apigee.net/xml\u003c/URL\u003e\n \u003c/HTTPTargetConnection\u003e\n ...\n ```\n7. To save your changes to the proxy configuration, click the **Save**\n button.\n\n Apigee saves your changes in a new proxy revision.\n8. To deploy the new revision, select **Deploy to: test** and click **Deploy 2**.\n9. In the confirmation dialog, click **Deploy** .\n\n If there is an error, Apigee will save your changes but not deploy the proxy. In the\n case of an error:\n 1. Fix your proxy configuration. Apigee may provide syntax guidance as a pop-up.\n 2. Manually deploy your changes to the `test` environment by clicking **Deployment \\\u003e test** if Apigee does not automatically deploy it.\n\n You can check if your proxy revision was deployed successfully by viewing the\n deployment revision status adjacent to the Deploy drop-down. For example:\n\nTest the proxy\n--------------\n\nTo test the API proxy revision, call the proxy just as you did in\n[Call an API proxy](/apigee/docs/api-platform/get-started/test-proxy).\n\nThis time, the mocktarget endpoint returns XML in the body of the response: \n\n```text\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003croot\u003e\n \u003ccity\u003eSan Jose\u003c/city\u003e\n \u003cfirstName\u003eJohn\u003c/firstName\u003e\n \u003clastName\u003eDoe\u003c/lastName\u003e\n \u003cstate\u003eCA\u003c/state\u003e\n\u003c/root\u003e\n```\n\nNow that the API proxy returns XML data, in the next step you will add a policy\nthat converts XML to JSON.\n[1](/apigee/docs/api-platform/get-started/create-proxy) [2](/apigee/docs/api-platform/get-started/deploy-proxy) [3](/apigee/docs/api-platform/get-started/test-proxy) [4](/apigee/docs/api-platform/get-started/change-endpoint) [(NEXT) Step 5: Add a policy](/apigee/docs/api-platform/get-started/add-policy)\n\n\u003cbr /\u003e"]]
.
