Depurar la monetización mediante la herramienta de depuración

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

Consulta la documentación de Apigee Edge.

Depura la monetización con Depuración, como se describe en las siguientes secciones.

Depura la fase de la política de autenticación

La monetización de Apigee usa la política de VerifyAPIKey o VerifyAccessToken para determinar si una solicitud entrante se puede monetizar mediante la verificación del plan de tarifas publicado activo. Si quieres obtener más información para agregar la política, consulta Agrega una política de autenticación.

Por ejemplo, en la siguiente imagen, se muestran los detalles de la fase de política VerifyAPIKey en el flujo de solicitud.

Después de autenticar al usuario, la política de VerifyAPIKey verifica todos los planes de tarifas publicados para determinar cuál está activo (si hay alguno) en función de su hora de activación y vencimiento. Si se encuentra un plan de tarifas publicado activo, se propagan las siguientes variables de flujo:

Variable de flujo	Configuración
mint.mintng_is_apiproduct_monetized	true si se encuentra un plan de tarifas publicado activo.
mint.mintng_rate_plan_id	ID de plan de tarifa.
mint.rateplan_end_time_ms	Hora de vencimiento del plan de tarifas. Por ejemplo: 1619433556408.
mint.rateplan_start_time_ms	Hora de activación del plan de tarifas. Por ejemplo: 1618433956209.

Si no se encuentra un plan de tarifas publicado activo, la variable de flujo mint.mintng_is_apiproduct_monetized se establece en false y las variables de flujo adicionales no se propagan.

Para obtener más información, consulta las variables de flujo mint.

Depuración de la fase de política MonetizationLimitsCheck

La monetización de Apigee usa la política MonetizationLimitsCheck para aplicar suscripciones de desarrollador al producto de API. Si quieres obtener más información para agregar la política, consulta Aplica suscripciones de desarrollador a productos de API.

Nota: La política MonetizationLimitsCheck no tiene efecto si no se encuentra un plan de tarifas publicado activo y la variable de flujo mint.mintng_is_apiproduct_monetized se establece en false.

Por ejemplo, a continuación se muestran los detalles de la fase de la política MonetizationLimitsCheck en el flujo de solicitud.

Si el desarrollador compró una suscripción al producto de API, se propagan las siguientes variables de flujo:

Variable de flujo	Descripción
mint.limitscheck.is_request_blocked	true para las solicitudes bloqueadas.
mint.limitscheck.is_subscription_found	true si se encuentra una suscripción a la API
mint.limitscheck_purchased_product_name	Nombre del producto de la API comprado. Por ejemplo: MyProduct
mint.limitscheck.status_message	Mensaje de estado. Por ejemplo: limits_check_success.
mint.prepaid_developer_balance	Saldo actual en la cartera de cuentas prepagadas del desarrollador asociada con la moneda del plan de tarifas.
mint.prepaid_developer_currency	Moneda del saldo disponible en la variable mint.prepaid_developer_balance.
mint.subscription_end_time_ms	Hora de finalización de la suscripción al producto de API.
mint.subscription_start_time_ms	Hora de inicio de la suscripción al producto de API. Por ejemplo: 1618433956209.

Si el desarrollador no compró una suscripción al producto de API, haz lo siguiente:

• La variable de flujo mint.limitscheck_is_subscription_found se configuró como false.
• mint.limitscheck.is_request_blocked se configura como true.
• No se propagan otras variables de flujo.

Para obtener más información, consulta las variables de flujo mint.

Depura la fase de la política de cuotas

La monetización de Apigee usa la política de cuotas para aplicar las cuotas definidas a nivel del producto de la API. Las cuotas definen la cantidad de solicitudes permitidas para un producto de API durante un período determinado. Si quieres obtener más información para agregar la política, consulta Aplica cuotas de monetización en proxies de API.

Nota: La política MonetizationLimitsCheck no tiene efecto si no se encuentra un plan de tarifas publicado activo y la variable de flujo mint.mintng_is_apiproduct_monetized se establece en false.

Por ejemplo, en la siguiente imagen se muestran los detalles de la fase de la política de cuotas en el flujo de solicitudes en el que se superó la cuota.

En este ejemplo, se superó la cuota, se muestra un estado HTTP 429 Too Many Requests y las variables de flujo ratelimit.* del flujo se propagan para proporcionar más detalles sobre la excepción de cuota. Para obtener una descripción de ratelimit.*, consulta las variables de flujo de la política de cuotas.

Depura la fase de políticas de DataCapture

Apigee usa las variables de monetización que captura la política de DataCapture para calificar, calcular el reparto de ingresos y las estadísticas. Para obtener más información sobre la captura de variables de monetización en la política, consulta Captura datos de monetización.

Por ejemplo, en la siguiente imagen, se muestran los detalles de la fase de ejecución de la política de DataCapture en el flujo de respuesta.

Si no hay errores cuando se capturan las variables de monetización, las siguientes variables de flujo se propagan para una transacción:

Variable de flujo	Descripción
mint.mintng_currency	Moneda para calcular los ingresos. Esta variable de flujo tiene el valor de la variable de monetización currency.
mint.mintng_price	Ingresos para calcular el porcentaje del desarrollador. Esta variable de flujo tiene el valor de la variable de monetización revShareGrossPrice.
mint.mintng_price_multiplier	El factor (multiplicador) por el que se multiplica el costo por transacción. Esta variable de flujo tiene el valor de la variable de monetización perUnitPriceMultiplier.
mint.mintng_tx_success	Especifica si la transacción se monetiza. Esta variable de flujo tiene el valor de la variable de monetización transactionSuccess.

Depuración de la fase de ejecución del proxy de API monetizada

Después de la ejecución correcta del proxy de API monetizado, se propaga un conjunto de variables de flujo con información sobre las tarifas y tarifas basadas en el consumo de monetización que se cobran.

Por ejemplo, en la siguiente imagen, se muestran los detalles de la fase de Proxy Execution en el flujo PostClient en el que se propagan las variables.

Si la ejecución del proxy de API de monetización se realiza correctamente, se propagan las siguientes variables de flujo:

Variable de flujo	Descripción
message.status.code	Código de estado HTTP del mensaje de respuesta del destino Si tienes alguna política en tu respuesta, el código de estado que muestra la política anula el valor de esta variable.
mint.limitscheck.is_request_blocked	Marca que especifica si la solicitud a la API está bloqueada.
mint.mintng_consumption_pricing_rates	Tarifas basadas en el consumo establecidas en el plan de tarifas.
mint.mintng_consumption_pricing_type	Tipo de precio basado en el consumo establecido en el plan de tarifas. Por ejemplo: FIXED_PER_UNIT.
mint.mintng_dev_share	Ingresos que se compartirán con el desarrollador.
mint.mintng_price_multiplier	Factor (multiplicador) capturado de la política DataCapture. El costo por transacción se multiplica por este factor.
mint.mintng_rate	La tarifa que se cobra por la llamada a la API.
mint.mintng_rate_before_multipliers	Tarifa que se cobra por la llamada a la API sin el cálculo perUnitPriceMultiplier.
mint.mintng_revenue_share_rates	Tarifas de reparto de ingresos establecidas en el plan de tarifas.
mint.mintng_revenue_share_type	Es el tipo de reparto de ingresos establecido en el plan de tarifas.
mint.prepaid_updated_developer_usage	Uso actual del desarrollador prepago.
mint.status	Estado de la llamada monetizada Se propaga solo cuando hay errores.
mint.status_code	Código de estado HTTP de la llamada monetizada Se propaga solo cuando hay errores.
mint.tx_success_result	Indica si la monetización se realizó de forma correcta para la transacción.

Para obtener una descripción detallada de todas las variables, consulta Variables de flujo de mint.