Herramientas de desarrollo

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

Como proveedor de servicios, desarrollas APIs para el consumo por parte de las apps cliente. A fin de crear, configurar y mantener proxies de API y productos de API, puedes usar la IU o realizar solicitudes HTTP a las API para acceder a los servicios RESTful, como se describe en las siguientes secciones.

Usa la IU de Edge

La IU de Apigee Edge es una herramienta basada en el navegador que puedes usar para crear, configurar y administrar proxies y productos de API. Un subconjunto de tareas solo se puede realizar con la API.

En la siguiente tabla, se describe cómo acceder a la IU de Edge:

Producto Nombre de la IU URL de acceso
Conexión de integración IU de Edge

Para acceder a la IU de Edge, usa la siguiente URL:

https://apigee.com/edge

Para ver un instructivo sobre el uso de la IU de Edge, consulta Compila tu primer proxy de API.

Perímetro para la nube privada IU clásica de Edge

A fin de acceder a la IU de Edge para la nube privada, usa la siguiente URL:

http://ms-ip:9000

Donde ms-ip es la dirección IP o el nombre de DNS del nodo del servidor de administración.

Con la IU de Edge, puedes hacer lo siguiente:

  • Para crear proxies de API, edita el código y realiza un seguimiento de los flujos de solicitudes a través de estos.
  • Crear productos de API que agrupen proxies para exponerlos a las solicitudes de los clientes
  • Administra a los desarrolladores y sus apps.
  • Configurar tus entornos de prueba y producción
  • Implementa aplicaciones de JavaScript y Node.js.

En la siguiente imagen, se muestra el editor de proxy de API en la IU que puedes usar para crear y configurar un proxy de API:

Muestra la pestaña Desarrollo seleccionada en el editor de proxy de la API en la IU de Edge.

Usa la API de Edge

Puedes usar la API de Edge para administrar tus recursos de API. Las APIs también proporcionan acceso a capacidades de bajo nivel que la IU no expone.

Los extremos de la API a menudo toman datos que contienen información de configuración y requieren que pases la información de autenticación, como el nombre de usuario y la contraseña, para acceder a ellos. Con los principios de RESTful, puedes llamar a los métodos HTTP GET, POST, PUT y DELETE en cualquiera de los recursos de la API.

Para obtener una lista completa de las APIs de Apigee Edge, consulta la Referencia de la API de Apigee Edge.

Comprende la ruta base de la API de Edge

La ruta que usarás en las solicitudes a la API concatena lo siguiente:

  • Una ruta base que incluya el nombre de la organización Por ejemplo: https://api.enterprise.apigee.com/v1/organizations/org_name.
  • Un extremo que apunta al recurso de Edge al que accedes

Por ejemplo, si el nombre de tu organización es apibuilders, cada llamada que realices a la API usará la siguiente ruta base:

https://api.enterprise.apigee.com/v1/organizations/apibuilders

Para recuperar una lista de proxies de API en tu organización, deberías llamar a GET en:

https://api.enterprise.apigee.com/v1/organizations/apibuilders/apis

Muchos recursos tienen permisos según el entorno. Se proporcionan dos entornos de forma predeterminada: prueba y producción. Por ejemplo, el entorno define el alcance de las memorias caché. Una caché compartida llamada “mycache” se incluye de forma predeterminada en cada entorno.

Puedes enumerar las memorias caché llamando a GET en el recurso de caché de la siguiente manera:

https://api.enterprise.apigee.com/v1/organizations/apibuilders/environments/test/caches
https://api.enterprise.apigee.com/v1/organizations/apibuilders/environments/prod/caches

Autentica el acceso

Debes autenticarte en el servidor de la API cuando llamas a las APIs. Para ello, puedes usar uno de los métodos siguientes:

Además, Apigee recomienda que uses la autenticación de dos factores, como se describe en Habilita la autenticación de dos factores para tu cuenta de Apigee.

Límites de la API de Edge

Cada organización está limitada a las siguientes tarifas de llamadas a la API de Edge:

  • 10,000 llamadas por minuto para organizaciones con planes pagados
  • 600 llamadas por minuto para organizaciones de prueba

Los códigos de estado HTTP 401 y 403 no se descuentan de este límite. Las llamadas que excedan estos límites mostrarán un código de estado 429 Too Many Requests.

Sugerencias para trabajar con las APIs de Edge

En esta sección, se describen algunas técnicas que facilitan el trabajo con las APIs de Edge.

Abrevia URL de solicitud

Cuando compilas tu URL de solicitud a las APIs de Edge, puedes usar las siguientes abreviaturas:

  • /e = /environments
  • /o = /organizations
  • /r = /revisions

Si usas abreviaturas, debes usarlas de forma coherente. Es decir, abrevia todos los elementos de la ruta, como se indica más arriba y se ilustra en el siguiente ejemplo, o no incluyes ninguno. Si usas tanto elementos completos como abreviados en la misma ruta de acceso, se producirá un error.

Por ejemplo:

THIS:
https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval/environments/prod/apis/helloworld/revisions/1/deployments
CAN BE MUCH SHORTER:
https://api.enterprise.apigee.com/v1/o/ahamilton-eval/e/prod/apis/helloworld/r/1/deployments

Ejecuta comandos curl

Usar un cliente HTTP para realizar solicitudes a la API En muchos ejemplos de la documentación, se proporcionan solicitudes de muestra a la API mediante curl, un cliente HTTP muy usado. Si necesitas instalar curl, puedes descargarlo desde http://curl.haxx.se.

Las llamadas a la API admiten la compresión gzip en las respuestas. Si configuras 'Accept-Encoding: gzip, deflate' en tus llamadas a la API, cualquier respuesta superior a 1,024 bytes se muestra en formato gzip.

Cómo dar formato a las solicitudes y respuestas XML y JSON

La API de Edge muestra los datos en formato JSON de forma predeterminada. En muchas solicitudes, puedes recibir la respuesta como XML. Para ello, configura el encabezado de la solicitud Accept como application/xml, como se muestra en el siguiente ejemplo:

curl -H "Authorization: Bearer `get_token`" \
  -H "Accept: application/xml" \
  https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval/apis/helloworld/revisions/1/policies/ \
  | xmllint --format -

La respuesta debería verse de la siguiente manera:

<List>
  <Item>SOAP-Message-Validation-1</Item>
  <Item>Spike-Arrest-1</Item>
  <Item>XML-to-JSON-1</Item>
</List>

Ten en cuenta que, en este ejemplo, se usa prettyprint para mostrar los resultados canalizando la respuesta a través de xmllint.

La utilidad acurl no admite el encabezado Accept. Como resultado, solo puedes obtener respuestas en formato JSON con acurl.

Si deseas usar prettyprint para una respuesta JSON, puedes usar la biblioteca json.tool de Python:

curl https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval/apis/helloworld/revisions/1/policies/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer `get_token`" \
  | python -m json.tool

A continuación, se proporciona un ejemplo de la respuesta.

[
  "SOAP-Message-Validation-1",
  "Spike-Arrest-1",
  "XML-to-JSON-1"
]

Para XML, puedes usar xmllint:

curl https://ahamilton-eval-test.apigee.net/getstarted -u email_address | xmllint --format -

Cuando publiques o pongas cargas útiles en XML, usa el encabezado HTTP Content-type:

acurl -H "Content-type:text/xml" -X POST -d \
'<XMLPayload>
 </XMLPayload> ' \
https://api.enterprise.apigee.com/v1/organizations/apifactory/apis -u email_address

Entornos de implementación

Todas las organizaciones que usan Apigee Edge de forma predeterminada tienen al menos dos entornos que pueden usar para desarrollar, probar e implementar APIs: “probar” y “prod”. Usa el entorno de “prueba” para desarrollar y probar tus APIs antes de que estén disponibles para el público. Solo tus desarrolladores internos pueden acceder a las APIs implementadas en el entorno de pruebas. Implementa tus APIs en el entorno “prod” a fin de que estén disponibles públicamente para los desarrolladores de apps.

Depuración y pruebas

Apigee proporciona una herramienta de seguimiento que te permite depurar flujos de solicitud y respuesta de extremo a extremo. Los resultados del seguimiento muestran las cargas útiles y los encabezados de solicitud y respuesta, la ejecución de políticas, los valores de las variables y cualquier error que pueda haber ocurrido durante el flujo.

Puntos de datos clave para usar en la solución de problemas:

  • Marcas de tiempo: Usa marcas de tiempo para ver cuánto tiempo tarda la ejecución de cada paso. La comparación de las marcas de tiempo te ayuda a aislar las políticas que tardan más en ejecutarse y que ralentizan las llamadas a la API.
  • Ruta base: Si verificas la ruta base, puedes asegurarte de que una política enruta el mensaje al servidor correcto.
  • Resultados de la ejecución de la política: Estos resultados te permiten ver si el mensaje se altera como se espera; por ejemplo, si el mensaje se está transformando de XML a JSON o si el mensaje se está almacenando en caché.

En la siguiente figura, se muestran los resultados de seguimiento:

Muestra la pestaña Trace seleccionada en el editor de proxy de la API en la IU de Edge.

Cada sesión de Trace se divide en los siguientes pasos principales:

  • Solicitud original recibida del cliente: Muestra el verbo y la ruta del URI de la solicitud desde la app cliente, los encabezados, los datos del cuerpo y los parámetros de consulta.
  • Solicitud enviada a tu servicio de backend: Muestra el mensaje de solicitud que el proxy de API envió al servicio de backend.
  • Respuesta que muestra el servicio de backend: Muestra los encabezados de respuesta y la carga útil que muestra el servicio de backend.
  • Se envía la respuesta final al cliente: Es el mensaje de respuesta que se muestra a la app cliente solicitante una vez que se ejecuta el flujo de respuesta.