Passaggio 4: modifica dell'endpoint di destinazione

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Un proxy API Apigee ha due endpoint: un endpoint proxy e un endpoint di destinazione. L'endpoint del proxy è l'interfaccia client. Riceve le richieste dai clienti e invia loro le risposte. L'endpoint target è l'interfaccia del produttore dell'API. Comunica da Apigee a un produttore di API, ad esempio un servizio o un'API di backend. Per scoprire di più sugli endpoint, consulta Che cos'è un proxy API?

In questo passaggio, cambierai 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, dovrai eseguire nuovamente il deployment e testare il proxy API aggiornato.

Nota: è disponibile una nuova versione dell'interfaccia utente di Apigee, integrata con la console Google Cloud. La nuova UI si chiama Apigee nella console Cloud. Le istruzioni nelle prime due schede riportate di seguito spiegano come utilizzare Apigee nella console Cloud o l'interfaccia utente Apigee classica.

Apigee nella console Cloud

1. Apri la UI di Apigee nella console Cloud in un browser.
2. Assicurati che nel menu a discesa nella parte superiore della pagina sia selezionato lo stesso progetto Google Cloud in cui hai creato il proxy API.
3. Seleziona Sviluppo proxy > Proxy API.
4. Nella tabella dei proxy, seleziona il proxy myproxy che hai creato nel passaggio 1: crea un proxy API.
5. Fai clic sulla scheda Sviluppa.

Esplorare la visualizzazione Sviluppa

Nel riquadro a sinistra della visualizzazione Sviluppa, puoi:

• Cerca il testo nel proxy nel campo Cerca nel proxy.
• Aggiungi nuove norme.
• Aggiungi endpoint proxy e target.
• Aggiungi altre risorse.

Se non vuoi visualizzare il riquadro a sinistra, puoi chiuderlo facendo clic sul pulsante di chiusura .

Il riquadro a destra della visualizzazione Sviluppa mostra gli editor di testo e di immagini per il proxy:

• L'editor visivo fornisce una visualizzazione grafica del flusso di richiesta e risposta.
• L'editor di testo ti consente di modificare il file XML per il proxy o il target.

Note:

• Puoi fare clic e trascinare la barra di divisione tra i due editor verso l'alto o verso il basso per espandere l'area di visualizzazione di ciascun editor.
• Puoi espandere l'area di visualizzazione dell'editor di testo facendo clic sul pulsante di attivazione/disattivazione sul lato destro dell'editor di testo, che chiude il riquadro dell'editor di testo. Fai clic di nuovo sul pulsante di attivazione/disattivazione per riaprire il riquadro dell'editor di testo.

Modificare l'endpoint di destinazione

Per modificare l'endpoint di destinazione del proxy:

1. Nel riquadro Revisione proxy, seleziona Endpoint target > predefinito.

   

   Nell'editor visivo viene visualizzato un diagramma dell'endpoint target:

   

   Sotto l'editor visivo, il codice XML per l'endpoint di destinazione viene visualizzato nell'editor di testo:

   

2. Nell'editor di testo, cambia <URL> in https://mocktarget.apigee.net/xml. Aggiungi "/xml" all'URL esistente.

   Il nuovo URL è mostrato di seguito:

   ...
   <HTTPTargetConnection>
     <Properties/>
     <URL>https://mocktarget.apigee.net/xml</URL>
   </HTTPTargetConnection>
   ...

3. Fai clic sulla Freccia accanto a Salva in alto a destra nell'editor proxy e seleziona Salva come nuova revisione.
4. Per eseguire il deployment delle modifiche, fai clic su Esegui il deployment.
5. Nella finestra di dialogo Esegui il deployment, seleziona la revisione e l'ambiente in cui eseguire il deployment e fai clic su Esegui il deployment.

Interfaccia utente Apigee classica

Per modificare l'endpoint di destinazione del proxy:

1. Accedi all'interfaccia utente di Apigee.
2. Seleziona Sviluppa > Proxy API.
3. 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.

4. Fai clic sulla scheda Sviluppa:

   

   Verrà aperto l'editor proxy API. L'editor proxy ti consente di visualizzare la struttura del proxy API e di configurarne il flusso. Un flusso è solo il percorso graduale seguito da una richiesta di proxy API nella piattaforma Apigee. Altri tutorial tratteranno il concetto di flussi.

5. Nel riquadro Navigator, seleziona Endpoint di destinazione > predefinito > PreFlow:

   

   Apigee mostra le impostazioni dell'endpoint nel riquadro Codice:

   <TargetEndpoint name="default">
     <Description/>
     <FaultRules/>
     <PreFlow name="PreFlow">
       <Request/>
       <Response/>
     </PreFlow>
     <PostFlow name="PostFlow">
       <Request/>
       <Response/>
     </PostFlow>
     <Flows/>
     <HTTPTargetConnection>
       <Properties/>
       <URL>https://mocktarget.apigee.net</URL>
     </HTTPTargetConnection>
   </TargetEndpoint>

   L'endpoint di destinazione è definito dall'elemento <HTTPTargetConnection>.

6. Modifica l'URL in "https://mocktarget.apigee.net/xml". Aggiungi "/xml" all'URL esistente.

   Il nuovo URL restituisce un piccolo blocco di XML nel corpo della risposta.

   La configurazione dell'endpoint dovrebbe avere il seguente aspetto:

   ...
   <HTTPTargetConnection>
     <Properties/>
     <URL>https://mocktarget.apigee.net/xml</URL>
   </HTTPTargetConnection>
   ...

7. Per salvare le modifiche alla configurazione del proxy, fai clic sul pulsante Salva.

   Apigee salva le modifiche in una nuova revisione del proxy.

8. Per eseguire il deployment della nuova revisione, seleziona Esegui il deployment in: test e fai clic su Esegui il deployment 2.
9. Nella finestra di dialogo di conferma, fai clic su Esegui il deployment.

   In caso di errore, Apigee salverà le modifiche, ma non eseguirà il deployment del proxy. In caso di errore:

   1. Correggi la configurazione del proxy. Apigee potrebbe fornire indicazioni sulla sintassi sotto forma di popup.
   2. Esegui manualmente il deployment delle modifiche nell'ambiente test facendo clic su Deployment > test se Apigee non esegue il deployment automaticamente.

   Puoi verificare se la revisione del proxy è stata eseguita correttamente visualizzando lo stato della revisione del deployment accanto al menu a discesa Deploy. Ad esempio:

   

Testa il proxy

Per testare la revisione del proxy API, chiama il proxy come hai fatto in Chiamare un proxy API.

Questa volta, l'endpoint mocktarget restituisce XML nel corpo della risposta:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <city>San Jose</city>
  <firstName>John</firstName>
  <lastName>Doe</lastName>
  <state>CA</state>
</root>

Ora che il proxy API restituisce dati XML, nel passaggio successivo aggiungerai un criterio che converta XML in JSON.

1 2 3 4 (AVANTI) Passaggio 5: aggiungi un criterio