Paso 4: Cambia el extremo de destino.

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Ahora que ya probaste tu proxy nuevo, ya estás listo para agregarle una política. Sin embargo, antes de hacerlo debes cambiar el extremo de destino del proxy por uno que muestre algunos datos.

Recuerda que en el Paso 1: Crea un proxy de API, debes configurar el extremo de destino (en el campo API existente) como https://mocktarget.apigee.net. Supongamos que el extremo no mostró ningún dato interesante. Luego, puedes cambiar el extremo a uno que muestre algunos XML útiles. Esta sección explica cómo hacerlo.

Editor de proxies nuevo

Puedes cambiar el extremo de destino del proxy en la vista Desarrollo del editor de proxy. Para abrir la vista Desarrollo, haz lo siguiente:

  1. Selecciona Desarrollar > Proxies de API y, en el panel Proxies, selecciona el entorno para el proxy.

  2. En la lista de proxies, selecciona el proxy myproxy, que creaste en el Paso 1: Crea un proxy de API.
  3. Haz clic en la pestaña Desarrollar para mostrar la vista Desarrollar:

    Desarrolla la vista en el editor de proxy

Vista Desarrollar

En el panel izquierdo de la vista Desarrollar, puedes hacer lo siguiente:

  • Busca texto en el proxy en el campo Proxy de búsqueda.
  • Agrega políticas nuevas.
  • Agrega extremos de proxy y de destino.
  • Agrega otros recursos.

Si no deseas ver el panel izquierdo, puedes contraerlo haciendo clic en el botón para cerrar Cerrar el botón del panel de búsqueda.

En el panel derecho de la vista Desarrollar, se muestran los editores visuales y de texto para el proxy:

  • El editor visual proporciona una vista gráfica del flujo de solicitud y respuesta.
  • El editor de texto te permite editar el XML del proxy o de destino.

Editores visuales y de texto con divisor que se puede seleccionar

Notas:

  • Puedes hacer clic y arrastrar el divisor entre los dos editores hacia arriba o hacia abajo a fin de expandir el área de visualización de cualquiera de los editores.
  • Para expandir el área de visualización del editor visual, haz clic en el botón de activación, ubicado al lado derecho del editor de texto, que cierra el panel del editor de texto. Haz clic en el botón de activación de nuevo a fin de volver a abrir el panel del editor de texto.

Cambia el extremo de destino

Para cambiar el extremo de destino del proxy, sigue estos pasos:

  1. En el panel Revisión del proxy, selecciona Extremos de destino > predeterminado.

    Extremos de destino seleccionados en el Explorador de proxy.

    Aquí se muestra un diagrama del extremo de destino en el editor visual:

    Extremos de destino seleccionados en el Explorador de proxy.

    Debajo del editor visual, se muestra el código XML del extremo de destino en el editor de texto:

    XML para el extremo de destino que se muestra en el editor de texto

  2. En el editor de texto, cambia el <URL> a https://mocktarget.apigee.net/xml. (Agrega “/xml” a la URL existente).

    La URL nueva se muestra a continuación:

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  3. Haz clic en la flecha junto a Guardar en la parte superior derecha del Editor de proxies y selecciona Guardar como revisión nueva.
  4. Para implementar los cambios, haz clic en Implementar.
  5. En el cuadro de diálogo Implementar, selecciona la revisión y el entorno en el que deseas realizar la implementación y haz clic en Implementar.

Editor de proxies clásico

Para cambiar el extremo de destino del proxy, haz lo siguiente:

  1. Accede a la IU de Apigee.
  2. Selecciona Desarrolla > proxy de API.
  3. Selecciona el proxy de la lista para mostrar los detalles del proxy de API. Si no ves tu proxy en la lista, asegúrate de haber seleccionado la organización correcta, como se describe en Cambia entre organizaciones.
  4. Haz clic en la pestaña Develop:

    Pestaña Desarrollar

    Esta acción te llevará al Editor del proxy de API. El Editor de proxy te permite ver la estructura de tu proxy de API y configurar su flujo. (Un flujo es solo la ruta gradual que toma una solicitud de proxy de API a través de la plataforma de Apigee. Otros instructivos abordarán el concepto de flujos).

  5. En el panel Navegador, selecciona Extremos de destino > predeterminado > PreFlow:

    Apigee muestra la configuración del extremo en el panel Code:

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

    El extremo de destino se define mediante el elemento <HTTPTargetConnection>.

  6. Cambia la URL a "https://mocktarget.apigee.net/xml". (Agrega “/xml” a la URL existente).

    La URL nueva muestra un bloque pequeño de XML en el cuerpo de la respuesta.

    Tu configuración de extremo ahora debería verse como la siguiente:

    ...
    <HTTPTargetConnection>
      <Properties/>
      <URL>https://mocktarget.apigee.net/xml</URL>
    </HTTPTargetConnection>
    ...
  7. Para guardar los cambios en la configuración del proxy, haz clic en el botón Guardar.

    Apigee guarda los cambios en una revisión de proxy nueva.

  8. Para implementar la revisión nueva, selecciona Deploy to: test y selecciona Deploy 2.
  9. En el diálogo de confirmación, haz clic en Implementar.

    Si hay un error, Apigee guardará tus cambios, pero no implementará el proxy. Si ocurre un error, haz lo siguiente:

    1. Corrige la configuración del proxy. Apigee puede proporcionar orientación de sintaxis como una ventana emergente.
    2. Implementa de forma manual los cambios en el entorno test. Para ello haz clic en Deployment > test si Apigee no lo implementa de forma automática.

    Para verificar si la revisión del proxy se implementó de forma correcta, visualiza el estado de la revisión de implementación junto al menú desplegable Implementar. Por ejemplo:

Prueba el proxy

Para probar los cambios, envía una solicitud al proxy, como lo hiciste en Llama al proxy de API. En el siguiente ejemplo, se supone que el proxy se llama myproxy:

curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy

En el ejemplo anterior, YOUR ENV_GROUP_HOSTNAME es el nombre de host del grupo de entornos. Consulta Encuentra el nombre de host del grupo de entornos.

Esta vez, el extremo de mocktarget muestra XML en el cuerpo de la respuesta:

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

Ahora que el proxy de API muestra datos XML, en el siguiente paso agregarás una política que convierta el XML a JSON.

Próximo paso

1 2 3 4 (SIGUIENTE) Paso 5: Agrega una política