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 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

  1. Nella console Google Cloud , vai alla pagina Sviluppo proxy > Proxy API.

    Vai ai proxy API

  2. Assicurati che sia selezionato lo stesso progetto Google Cloud in cui hai creato il proxy API dal menu a discesa nella parte superiore della pagina.
  3. Nella tabella dei proxy, seleziona il proxy myproxy che hai creato nel passaggio 1: crea un proxy API.
  4. 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 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 Pulsante Chiudi riquadro di ricerca..

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.

Editor visivo e di 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 uno dei due 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 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 di destinazione > predefinito.

    Endpoint di destinazione selezionati in Proxy Explorer.

    Viene visualizzato un diagramma dell'endpoint di destinazione nell'editor visivo:

    Endpoint di destinazione selezionati in Proxy Explorer.

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

    XML per l'endpoint di destinazione visualizzato nell'editor di testo.

  2. 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>
...
  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.

UI Apigee classica

Per modificare l'endpoint di destinazione del proxy:

  1. Accedi alla UI 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:

    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.)

  5. Nel riquadro Navigator, seleziona Target Endpoints > default > 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 ora 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.

    Se si verifica un errore, Apigee salva le modifiche, ma non esegue il deployment del proxy. In caso di errore:

    1. Correggi la configurazione del proxy. Apigee potrebbe fornire indicazioni sulla sintassi come popup.
    2. 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 eseguita correttamente visualizzando lo stato della revisione del deployment accanto al menu a discesa Deployment. Ad esempio:

Testare 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:

<?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 converte XML in JSON.

1 2 3 4 (NEXT) Step 5: Add a policy