Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
SE APLICA A: Todos los niveles de API Management
Con la plataforma del servicio Azure API Management , puede hacer lo siguiente:
- Publique las API a las que se suscriben los consumidores.
- Mitigación de riesgos en la implementación.
- Acelere los plazos del proyecto.
- Escala tus API con confianza.
En este documento, nos centramos en las características de API Management que permiten la implementación de la estrategia de monetización, como proporcionar una experiencia sin fricción para:
- Descubra las API públicas.
- Escriba los detalles de pago.
- Active una suscripción.
- Consumir la API.
- Supervisar el uso.
- Paga automáticamente por el uso de la API.
En el diagrama siguiente se presentan estas características clave de API Management:
Detección de API
Inicie la API e incorpore consumidores de API mediante el portal para desarrolladores integrado de API Management. Resalte el contenido de desarrollo de buena calidad para el portal para desarrolladores, lo que permite a los consumidores de API explorar y usar las API sin problemas. Pruebe el contenido y la información proporcionadas para accesibilidad, detalle y facilidad de uso.
Para obtener información sobre cómo agregar contenido y controlar la personalización de marca del portal para desarrolladores, consulte Información general del portal para desarrolladores.
Empaquetado de API
API Management le permite administrar cómo se empaquetan y presentan las API mediante el concepto de productos y directivas.
Products
Las API se publican a través de productos. Los productos permiten definir:
- A qué API puede acceder un suscriptor.
- Directivas de limitación específicas, como limitar una suscripción específica a una cuota de llamadas al mes.
Cuando un consumidor de API se suscribe a un producto, recibe una clave de API que puede usar para realizar llamadas. Inicialmente, la suscripción se establece en el estado submitted. Active la suscripción para permitir que los suscriptores usen las API.
Puede configurar los productos de API Management para empaquetar la API subyacente para reflejar el modelo de ingresos, con:
- Una relación uno a uno entre cada nivel del modelo de ingresos.
- Un producto de API Management correspondiente.
Los proyectos de ejemplo usan productos de API Management como medio de nivel superior para codificar la estrategia de monetización. Los productos de API Management reflejan los niveles del modelo de ingresos e indexa el modelo de precios específico para cada nivel. Esta configuración proporciona un enfoque flexible basado en la configuración para preparar la estrategia de monetización.
Policies
Aplique directivas de API Management para controlar la calidad del servicio para cada producto. Los proyectos de ejemplo usan dos características de directiva específicas para controlar la calidad del servicio, en línea con el modelo de ingresos:
| Característica de política | Description |
|---|---|
| Cuota | Define el número total de llamadas que el usuario puede realizar en la API durante un período de tiempo especificado, por ejemplo, 100 llamadas al mes. Una vez que el usuario alcanza la cuota, se produce un error en las llamadas a la API y el autor de la llamada recibe un 403 Forbidden código de estado de respuesta. |
| Límite de velocidad | Define el número de llamadas en un período de tiempo deslizante que se puede realizar en la API, por ejemplo, 200 llamadas por minuto. Diseñado para evitar picos en el uso de la API más allá de la calidad de servicio de pago con el producto elegido. Cuando se supera la tasa de llamadas, el autor de la llamada recibe un 429 Too Many Requests código de estado de respuesta. |
Para más información sobre las directivas, consulte Directivas en Azure API Management.
Consumo de API
Conceda a los consumidores de API acceso a las API a través de productos que usan suscripciones de API.
- Los consumidores de API establecen suscripciones de API al registrarse para un producto específico de API Management.
- Integre el proceso de suscripción con el proveedor de pagos mediante la delegación de API Management.
- Después de proporcionar correctamente los detalles de pago, los usuarios obtienen acceso a la API con una clave de seguridad única generada para la suscripción.
Para más información sobre las suscripciones, consulte Suscripciones en Azure API Management.
Supervisión del uso de API
Puede obtener información sobre el uso y el rendimiento de la API mediante el análisis integrado de API Management. Estos análisis proporcionan informes según
- API
- Geografía
- Operaciones de la API REST
- Producto
- Solicitud
- Subscription
- Time
- Usuario
Revise los informes de análisis periódicamente para comprender cómo los consumidores de api adoptan la estrategia de monetización.
Para obtener más información, consulte Monitor API Management.
Security
Controlar el nivel de acceso de cada usuario a cada producto mediante los productos, las directivas de API y las suscripciones de API Management. Evite el uso indebido y el abuso al conceder acceso a la API de nivel de suscripción si el usuario se ha autenticado correctamente con el proveedor de pagos, incluso si el producto de API específico es gratuito.
Integration
Cree una experiencia de monetización sin problemas a través de la integración de front-end y back-end entre API Management y el proveedor de pagos elegido. Use la delegación de API Management para la integración de front-end y la API REST para la integración de back-end.
Delegación
En los proyectos de ejemplo, puede usar la delegación de API Management para realizar integraciones personalizadas con los proveedores de pago asociados. La demostración utiliza la delegación tanto para las experiencias de registro/inicio de sesión como para las de suscripción de productos.
Flujo de trabajo de registro o inicio de sesión
- El desarrollador selecciona el vínculo de inicio de sesión o registro en el portal para desarrolladores de API Management.
- El explorador web redirige al punto de conexión de delegación (configurado en una página de la aplicación del portal de facturación personalizada).
- La aplicación del portal de facturación personalizada presenta una interfaz de usuario de inicio de sesión o registro.
- Tras iniciar sesión o registrarse correctamente, el usuario se autentica y se redirige de nuevo a la página de inicio del portal para desarrolladores de API Management.
Flujo de trabajo de suscripción de producto
- El desarrollador selecciona un producto en el portal para desarrolladores de API Management y elige el botón Suscribirse .
- El explorador web redirige al punto de conexión de delegación (configurado en una página de la aplicación del portal de facturación personalizada).
- La aplicación del portal de facturación personalizada:
- Presenta una interfaz de usuario configurada en función del proveedor de pagos (Stripe o Adyen).
- Lleva al usuario a través del proceso de pago correspondiente.
- El usuario se redirige de nuevo a la página de producto de API Management inicial.
- El producto está activo y las claves de API están disponibles.
REST API
Use la API REST para API Management para automatizar el funcionamiento de la estrategia de monetización.
Los proyectos de ejemplo utilizan la API para realizar tareas de forma programática.
- Recupere los productos y directivas de API Management para habilitar la configuración sincronizada de conceptos similares en proveedores de pago, como Stripe.
- Controle la gestión de API periódicamente para recuperar las métricas de uso de API de cada suscripción e impulsar el proceso de facturación.
Para más información, consulte Referencia de la API REST de Azure API Management.
DevOps
Implemente el control de versiones y automatice los cambios de implementación en API Management mediante Azure Resource Manager, incluida la configuración de características que implementan la estrategia de monetización, como:
- Products
- Policies
- Portal para desarrolladores
En proyectos de ejemplo, los scripts de Azure Resource Manager se aumentan mediante un archivo JSON, que define el modelo de precios de cada producto de API Management. Con este aumento, puede sincronizar la configuración entre API Management y el proveedor de pagos elegido. Toda la solución se administra en un único repositorio de control de código fuente para:
- Coordinar todos los cambios asociados a la evolución de la estrategia de monetización en curso como una sola versión.
- Realice los cambios, siguiendo los requisitos de gobernanza y auditoría.
Inicialización e implementación
API Management se puede implementar mediante:
- El portal de Azure
- Un enfoque de infraestructura como código mediante plantillas de Azure Resource Manager