Usa los proxies de API de muestra

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Requisitos previos

Necesitarás una cuenta en http://enterprise.apigee.com. Puedes registrarte para obtener una cuenta de prueba en http://accounts.apigee.com/accounts/sign_up.

Para usar muestras, también debes tener lo siguiente:

Herramienta Descripción
Git Las muestras se encuentran en GitHub. Si no tienes Git instalado, consulta las instrucciones de configuración de Git de GitHub. Si no quieres instalar Git, puedes explorar los archivos y descargar un archivo ZIP en https://github.com/apigee/api-platform-samples.
Python

Se requiere Python para ejecutar la herramienta de implementación de Apigee. Python está presente en la mayoría de los entornos de Linux, en una Mac con Xcode instalado, en una máquina Windows con Cygwin instalado y en muchos otros lugares.

Para obtener Python, consulta la página de descargas de Python.

curl Las secuencias de comandos de configuración de muestra también usan curl. Asegúrate de que curl esté instalado y disponible en tu ruta de acceso (ejecuta el comando which curl para ver si está disponible en tu sistema).
dos2unix Si ejecutas Cygwin en Windows, es posible que también necesites la utilidad dos2unix. (El instalador de Cygwin te permite instalar la utilidad).

Descarga las muestras

Para obtener los archivos de muestra, usa git clone, como se indica en el siguiente ejemplo:

git clone https://github.com/apigee/api-platform-samples.git

Importa e implementa los proxies de API de muestra

Importa e implementa las muestras desde la línea de comandos:

  1. Después de descargar las muestras, ve al directorio /setup, como se muestra en el siguiente ejemplo:
    cd setup
  2. En el directorio /setup, busca el archivo setenv.sh.
  3. Edita este archivo para configurar la organización, la dirección de correo electrónico asociada con tu nombre de usuario y el entorno (producción o prueba) en el que deseas implementar los proxies de API.
  4. Después de editar setenv.sh, ejecuta lo siguiente:
    sh deploy_all.sh

    Esta secuencia de comandos implementa todas las muestras de proxy de API en tu organización. (El proceso tarda entre 3 y 4 minutos). Sigue las indicaciones para implementar productos de API, desarrolladores y apps (que se usan para OAuth).

  5. Cuando se complete la secuencia de comandos de implementación, navega al directorio sample-proxies. En el directorio sample-proxies, encontrarás un directorio por proxy de muestra. En cada directorio hay un archivo README.md con información sobre cómo ejecutar la muestra y dos secuencias de comandos que te ayudan a medida que realizas pequeños cambios en las muestras, las implementas y, luego, invocas la muestra para ver qué efecto tuvo el cambio:
    • invoke.sh: Ejecuta esta secuencia de comandos para invocar la versión implementada del proxy de API.
    • deploy.sh: Ejecuta esta secuencia de comandos para implementar el proxy de API después de realizar cualquier cambio.

Invoca los proxies de API de muestra

Cada proxy de muestra tiene una secuencia de comandos de shell asociada que se puede usar para invocar el proxy de API después de implementarlo.

Desde el directorio /sample-proxies/proxy_name, ejecuta lo siguiente:

sh invoke.sh

Esto invoca el proxy que se ejecuta en el entorno de pruebas de tu organización.

Solución de problemas

Para obtener información sobre la solución de problemas, consulta lo siguiente:

Modifica y reutiliza los proxies de API de muestra

El uso típico de los proxies de muestra es modificar, implementar y, luego, invocar. Esto te permite hacer pequeñas modificaciones y, luego, ver qué efecto tienen en el mensaje de respuesta.

Si deseas modificar un proxy de API de muestra para que apunte a un servicio de backend diferente, modifica el archivo de configuración XML en la siguiente ubicación:

/apiproxy/targets/target_name.xml

Por ejemplo, para apuntar la muestra de la clave de API a tu propio servicio de backend, ubica este archivo:

/apikey/apiproxy/targets/default.xml

Si la configuración predeterminada apunta a http://mocktarget.apigee.net, por ejemplo:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

Si tu servicio de backend está disponible en http://api.myproject.com/, modificarás la configuración para que se vea de la siguiente manera:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://api.myproject.com/</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

Después de guardar los cambios, implementa el proxy de API como se muestra en el siguiente ejemplo:

sh deploy.sh

Los otros proxies de API se pueden modificar de la misma manera para usar la funcionalidad del proxy de API en tus servicios de destino existentes. Sin embargo, en algunos casos, el comportamiento del proxy de API depende de formatos de mensaje específicos, por lo que es posible que los proxies necesiten cambios de configuración adicionales.