Questa pagina è stata tradotta dall'API Cloud Translation.

Passaggio 4: modifica dell'endpoint di destinazione

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Ora che hai testato il nuovo proxy, sei quasi pronto per aggiungere un criterio. Prima di farlo, tuttavia, modifica l'endpoint di destinazione del proxy scegliendone uno che restituisca alcuni dati.

Ricorda che nel Passaggio 1: crea un proxy API, imposti l'endpoint di destinazione (nel campo API esistente) su https://mocktarget.apigee.net. Supponiamo che l'endpoint non abbia restituito dati interessanti. Quindi puoi cambiare l'endpoint con uno che restituisca XML utili. Questa sezione spiega come eseguire questa operazione.

Nuovo editor proxy

Puoi modificare l'endpoint di destinazione di un proxy nella visualizzazione Sviluppo dell'editor del proxy. Per aprire la visualizzazione Sviluppo:

Seleziona Sviluppo > Proxy API e nel riquadro proxy, seleziona l'ambiente per il proxy.
Nell'elenco dei proxy, seleziona il proxy myproxy, che hai creato nel Passaggio 1: crea un proxy API.
Fai clic sulla scheda Sviluppo per passare alla visualizzazione Sviluppo:

Visualizzazione Sviluppo

Nel riquadro a sinistra della visualizzazione Sviluppo, puoi:

Cerca del testo nel proxy nel campo Proxy di ricerca.
Aggiungi nuovi criteri.
Aggiungi endpoint proxy e di destinazione.
Aggiungi altre risorse.

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

Il riquadro a destra della vista Sviluppo mostra gli editor visivi e di testo del proxy:

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

Editor di immagini e testo con divisore selezionabile.

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 entrambi gli editor.
Puoi espandere l'area di visualizzazione dell'editor visivo 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 di attivazione/disattivazione per riaprire il riquadro dell'editor di testo.

Modifica 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 di testo, il codice XML dell'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.

Il nuovo URL è mostrato di seguito:
```
...
<HTTPTargetConnection>
  <Properties/>
  <URL>https://mocktarget.apigee.net/xml</URL>
</HTTPTargetConnection>
...
```
Fai clic sulla freccia accanto a Salva in alto a destra in Proxy Editor e seleziona Salva come nuova revisione.
Per eseguire il deployment delle modifiche, fai clic su Esegui il deployment.
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.

Editor proxy classico

Per modificare l'endpoint di destinazione del proxy:

Accedi all'interfaccia utente di Apigee.
Seleziona Sviluppo > Proxy API.
Seleziona il tuo proxy dall'elenco per visualizzare i dettagli del proxy API. Se il tuo proxy non è visualizzato nell'elenco, assicurati di aver selezionato l'organizzazione corretta, come descritto in Passaggio da un'organizzazione all'altra.
Fai clic sulla scheda Sviluppo:

Viene visualizzato l'editor proxy API. L'editor del proxy consente di visualizzare la struttura del proxy API e di configurarne il flusso. (Un flusso è solo il percorso graduale che una richiesta proxy API esegue attraverso la piattaforma Apigee. Altri tutorial tratteranno il concetto di flussi.)

Nel riquadro Navigazione, 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 target è definito dall'elemento <HTTPTargetConnection>.

Cambia 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 ora dovrebbe avere il seguente aspetto:
```
...
<HTTPTargetConnection>
  <Properties/>
  <URL>https://mocktarget.apigee.net/xml</URL>
</HTTPTargetConnection>
...
```
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 a: test e fai clic su Esegui il deployment 2.
Nella finestra di dialogo di conferma, fai clic su Esegui il deployment.
Se si verifica un errore, Apigee salverà le modifiche, ma non eseguirà il deployment del proxy. In caso di errore:
1. Correggi la configurazione del proxy. Apigee può fornire indicazioni sulla sintassi come popup.
2. Esegui manualmente il deployment delle modifiche nell'ambiente test facendo clic su Deployment > test se Apigee non ne esegue automaticamente il deployment.
Puoi verificare se il deployment della revisione del proxy è stato eseguito correttamente visualizzando lo stato di revisione del deployment accanto al menu a discesa Deployment. Ad esempio:

Testa il proxy

Puoi testare le modifiche inviando una richiesta al tuo proxy, come hai fatto in Chiamare il proxy API. L'esempio seguente presuppone che il proxy sia denominato myproxy:

curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

dove YOUR ENV_GROUP_HOSTNAME è il nome host del gruppo di ambienti. Vedi Trovare il nome host del gruppo di ambienti.

Questa volta, l'endpoint fittizio 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 i dati XML, nel passaggio successivo aggiungerai un criterio per convertire i file XML in JSON.

1 2 3 4 (AVANTI) Passaggio 5: aggiungi una norma