Administrar productos de API

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Administra los productos de API con la IU de administración de Apigee Edge, como se describe en esta sección. Para administrar productos de API con la API, consulta Cómo usar la API de administración de Edge para publicar APIs.

Para obtener una descripción general de los productos de API, consulta ¿Qué es un producto de API?.

Explora la página de productos de API

Accede a la página de productos de API, como se describe a continuación.

Agrega un producto de API

Agrega un producto de API con la IU, como se describe a continuación. Para usar la API de Edge, consulta Configura productos de API con la API.

Para agregar un producto de API con la IU de Edge, sigue estos pasos:

1. Accede a la página de productos de la API, como se describió antes en esta sección.
2. Haz clic en +API Product.
3. Ingresa los detalles del producto para el producto de API.
   

   Campo	Descripción
   Nombre	Nombre interno del producto de API. No puedes editar el nombre una vez que se crea el producto de API. No especifiques caracteres especiales en el nombre.
   Nombre visible	Nombre visible del producto de API. El nombre visible se usa en la IU y se puede editar en cualquier momento. Si no se especifica, se usará el valor Nombre. Este campo se completa automáticamente con el valor Nombre. Puedes editar o borrar tu contenido. El nombre visible puede incluir caracteres especiales.
   Descripción	Descripción del producto de API.
   Entorno	Entornos a los que el producto de API permitirá el acceso Por ejemplo, test o prod.
   Acceso	Nivel de acceso. Para obtener detalles, consulta Nivel de acceso.
   Aprueba de manera automática las solicitudes de acceso	Habilita la aprobación automática de solicitudes clave para este producto de API desde cualquier aplicación. Para requerir la aprobación manual de claves, inhabilita esta opción. Consulta Registra apps y administra claves de API (IU) y Claves de apps para desarrolladores (API).
   Quota	Límite de cuota al que deseas hacer referencia desde las políticas de cuota. Ingresar un valor de cuota no aplica automáticamente las restricciones en la cantidad de llamadas que se pueden realizar a través del producto. Los proxies de API a los que hace referencia el producto deben incluir la política de cuotas para aplicar la cuota. Para obtener más información, consulta Cuotas.
   Permisos de OAuth permitidos	Si usas OAuth con el producto de API, los permisos de OAuth permitidos que deseas que el producto de API permita (como Lectura o cualquier otro permiso que las apps envíen con sus llamadas a la API). Especifica varios permisos como una lista separada por comas. Consulta Alcances de OAuth.

4. Agrega los recursos de API que están disponibles en el producto de API, incluidos los proxies de API y las rutas de recursos.

   Por ejemplo, si agregas un proxy de API "music" al producto con una ruta base de /music, el producto de API permitirá las llamadas a /music. Sin embargo, si deseas que el producto de API permita acceder solo a la ruta del recurso venues, que tiene un URI de /music/venues, agrega la ruta del recurso /venues al producto. En este caso, se permiten las llamadas a /music/venues?name=paramount, pero se bloquearán las llamadas a /music/artists?name=Jack%Johnson.

   Establece una ruta de recursos específica o establece la ruta base y todas las rutas secundarias posibles si especificas la ruta de recursos como /. La ruta de recursos puede incluir comodines /** y /*. El comodín de doble asterisco indica que se admiten todas las rutas secundarias de la ruta base, pero no la ruta base. Un asterisco único indica que solo se admiten los URI de un nivel inferior a la ruta base. Consulta Configura el comportamiento de una ruta de acceso de los recursos '/', '/*' y '/**', como se describe más adelante en esta sección.

   Para agregar recursos de API, haz lo siguiente:

   1. Haz clic en Add a proxy o Add a path en la sección API resources.
   2. Elige si deseas agregar un proxy de API, una ruta de acceso o ambos, proxy y ruta de API.

      

   3. Agrega uno o más proxies de API y rutas de recursos.

      Ten en cuenta lo siguiente:

      • Las rutas de recursos que definas se aplican a todos los proxies de API agregados al producto de API.
      • Las rutas de recursos más inclusivas y menos específicas tienen prioridad sobre las que son más específicas. Por ejemplo, si agregas / y /**, la ruta de recurso / tendrá prioridad y se ignorará la ruta de recurso /**.

      Por ejemplo:

      

   4. Haz clic en Agregar o Agregar e iniciar otra (para especificar recursos de API adicionales).
5. (Opcional) Usa la sección Destinos del servicio remoto de Apigee para vincular el producto a uno o más destinos de servicio remoto. A menos que uses el adaptador de Envoy de Apigee, puedes ignorar esta configuración. Para obtener más información, consulta la Guía de operaciones del adaptador de Envoy de Apigee.

6. (Opcional) Usa la sección Atributos personalizados para agregar hasta 18 atributos personalizados a un producto de API.

   Los atributos personalizados son pares clave-valor que se pueden usar de muchas maneras, incluso para ayudar a controlar la ejecución del proxy de API. Por ejemplo, puedes crear un atributo personalizado llamado deprecated con un valor verdadero o falso. En el flujo de proxy de API, puedes verificar el valor del atributo deprecated del producto de API (por ejemplo, con la variable verifyapikey.{policy_name}.apiproduct.deprecated que está disponible automáticamente después de crear el atributo personalizado). Si su valor es verdadero (obsoleto), puedes generar un error con la política Raise Fault.

7. Haz clic en Guardar.

Configura el comportamiento de una ruta de acceso de los recursos '/', '/*' y '/**'

En la siguiente tabla, se muestra el comportamiento predeterminado de un producto de API para diferentes rutas de recursos. En este ejemplo, el proxy de API tiene una ruta base de /v1/weatherapikey. La ruta de recurso del producto de API se aplica al sufijo de la ruta de acceso después de la ruta base.

URI de solicitud	Permitido para /	Permitido para /*	Permitido para /**	Permitido para /*/2/**	Permitido para /*/2/*
/v1/weatherapikey	S	N	N	N	N
/v1/weatherapikey/	S	N	N	N	N
/v1/weatherapikey/1	S	Sí	S	N	N
/v1/weatherapikey/1/	S	Sí	S	N	N
/v1/weatherapikey/1/2	S	No	Sí	N	N
/v1/weatherapikey/1/2/	S	No	S	S	N
/v1/weatherapikey/1/2/3/	S	No	S	Sí	S
/v1/weatherapikey/1/a/2/3/	S	No	Sí	N	N

De forma predeterminada, una ruta de recurso de / en un producto de API admite la ruta base y todas las rutas secundarias. Por ejemplo, si la ruta base del proxy de API es /v1/weatherapikey, el producto de API admite solicitudes a /v1/weatherapikey y a cualquier ruta secundaria, como /v1/weatherapikey/forecastrss, /v1/weatherapikey/region/CA, etcétera.

Puedes cambiar esta configuración predeterminada para que una ruta de recurso / corresponda solo a la ruta base del proxy de API, lo que significa que el producto de API no permitirá el acceso a un URI que tenga algo después de /. Si realizas este cambio, en la tabla anterior, solo las dos primeras filas en "Permitido para /" contendrían "S".

Para cambiar el valor predeterminado, un administrador del sistema debe establecer el valor de la features.isSingleForwardSlashBlockingEnabled propiedad en tu organización como true. Los clientes de la nube pueden realizar esa solicitud a Apigee Edge Support.

Edita un producto de API

Para editar un producto de API, sigue estos pasos:

1. Accede a la página de productos de la API, como se describió antes en esta sección.
2. Haz clic en la fila del producto de API que quieres editar.
3. Haz clic en Editar en la página del producto de API.
4. Edita los campos según sea necesario.

   Puedes borrar los recursos que agregaste a un producto de API. Es posible que desees hacerlo si un recurso no funciona correctamente o necesita más desarrollo. Cuando se borra, ese recurso ya no forma parte del producto de API. Las apps que usan el producto de API ya no pueden acceder al recurso borrado. Los recursos borrados se quitan del producto, pero no se borran del sistema, de modo que otros productos puedan seguir usándolo.

5. Haz clic en Guardar.

Con Apigee Edge para la nube pública, Edge mantiene las siguientes entidades en caché durante un mínimo de 180 segundos después de que se accede a las entidades.

• Tokens de acceso de OAuth. Esto significa que un token revocado puede tener éxito hasta por tres minutos, hasta que su límite de caché caduque.
• Entidades del servicio de administración de claves (KMS) (apps, desarrolladores, productos de API).
• Atributos personalizados de entidades de KMS y tokens de OAuth.

Borra un producto de API

Antes de que puedas borrar un producto de API, debes anular el registro de las apps de desarrollador asociadas con ese producto o anular su asociación. Para ello, borra las apps o revoca las claves de API de la app.

Para borrar un producto de API, sigue estos pasos:

1. Accede a la página de productos de la API, como se describió antes en esta sección.
2. Coloca el cursor sobre el producto de API en la lista.
3. Haga clic en .
4. Haz clic en Borrar para confirmar la operación de borrado.