Depurar la monetización con 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 la herramienta de depuración, tal como se describe en las siguientes secciones.

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

La monetización de Apigee usa la política VerifyAPIKey o VerifyAccessToken para determinar si una solicitud entrante se puede monetizar comprobando si el plan de tarifas publicado está activo. Para obtener más información sobre cómo añadir la política, consulta Añadir una política de autenticación.

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

Detalles de la fase de la política VerifyAPIKey, incluidas las variables de flujo de monetización

Después de autenticar al usuario, la política VerifyAPIKey comprueba todos los planes de tarifas publicados para determinar cuál, si hay alguno, está activo en función de sus horas de activación y caducidad. Si se encuentra un plan de tarifas publicado activo, se rellenan las siguientes variables de flujo:

Variable de flujo Ajuste
mint.mintng_is_apiproduct_monetized true si se encuentra un plan de tarifas publicado activo.
mint.mintng_rate_plan_id ID del plan de tarifas.
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 ningún plan de tarifas publicado activo, la variable de flujo mint.mintng_is_apiproduct_monetized se asigna a false y las variables de flujo adicionales no se rellenan.

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

Depurar la fase de la política MonetizationLimitsCheck

La monetización de Apigee usa la política MonetizationLimitsCheck para aplicar las suscripciones de los desarrolladores al producto de API. Para obtener más información sobre cómo añadir la política, consulta el artículo Exigir a los desarrolladores que se suscriban a productos de API.

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

Detalles de la fase de la política MonetizationLimitsCheck, incluidas las variables del flujo de monetización

Si el desarrollador ha comprado una suscripción al producto de API, se rellenarán 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 API comprado. Por ejemplo: MyProduct
mint.limitscheck.status_message Mensaje de estado. Por ejemplo: limits_check_success
mint.prepaid_developer_balance Saldo actual de la cartera de la cuenta de prepago del desarrollador asociada a 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 ha comprado una suscripción al producto de API:

  • La variable de flujo mint.limitscheck_is_subscription_found se ha definido como false
  • mint.limitscheck.is_request_blocked está configurado como true
  • No se rellenan otras variables de flujo.

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

Depurar 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 de producto de API. Las cuotas definen el número de solicitudes permitidas para un producto de API durante un periodo determinado. Para obtener más información sobre cómo añadir la política, consulta Aplicar cuotas de monetización en proxies de API.

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 la que se ha superado la cuota.

Detalles de la fase de la política de cuotas, incluidas las variables de flujo de monetización

En este ejemplo, se ha superado la cuota, se devuelve el estado HTTP 429 Too Many Requests y se rellenan las variables de flujo ratelimit.* 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.

Depurar la fase de la política DataCapture

Apigee usa las variables de monetización capturadas por la política DataCapture para la valoración, el cálculo de la participación en los ingresos y las analíticas. Para obtener más información sobre cómo capturar las variables de monetización en la política, consulta Capturar datos de monetización.

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

Fase de ejecución de la política DataCapture con las variables de flujo de monetización

Si no se producen errores al capturar las variables de monetización, se rellenan las siguientes variables de flujo de 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 la parte del desarrollador.

Esta variable de flujo tiene el valor de la variable de monetización revShareGrossPrice.
mint.mintng_price_multiplier

Factor (multiplicador) por el que se multiplica el coste 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.

Depurar la fase de ejecución del proxy de API monetizado

Una vez que se haya ejecutado correctamente el proxy de API monetizado, se rellenará un conjunto de variables de flujo con información sobre las tarifas y los precios basados en el consumo de la monetización.

Por ejemplo, en la siguiente imagen se muestran los detalles de la fase Ejecución de proxy del flujo PostClient, donde se rellenan las variables.

Detalles de la fase de ejecución del proxy, incluidas las variables de flujo de monetización

Si la ejecución del proxy de API monetizado se realiza correctamente, se rellenan 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 incluye alguna política en su respuesta, el valor de esta variable se sustituirá por el código de estado devuelto por la política.
mint.limitscheck.is_request_blocked Marca que especifica si la solicitud de la API está bloqueada.
mint.mintng_consumption_pricing_rates Tarifas basadas en el consumo definidas en el plan de tarifas.
mint.mintng_consumption_pricing_type Tipo de precio basado en el consumo definido 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 coste por transacción se multiplica por este factor.
mint.mintng_rate

Tarifa cobrada por la llamada a la API.
mint.mintng_rate_before_multipliers Tarifa cobrada por la llamada a la API sin el cálculo de perUnitPriceMultiplier.
mint.mintng_revenue_share_rates Porcentajes del reparto de ingresos definidos en el plan de tarifas.
mint.mintng_revenue_share_type Tipo de reparto de ingresos definido en el plan de tarifas.
mint.prepaid_updated_developer_usage Uso actual del desarrollador de prepago.
mint.status Estado de la llamada monetizada. Solo se rellena si se produce un error.
mint.status_code Código de estado HTTP de la llamada monetizada. Solo se rellena si se produce un error.
mint.tx_success_result Indica si la monetización de la transacción se ha realizado correctamente.

Para ver una descripción detallada de todas las variables, consulta Variables de flujo de acuñación.