Política MonetizationLimitsCheck

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

Descripción general

La política MonetizationLimitsCheck te permite aplicar límites de monetización en las llamadas a la API que realiza el desarrollador de apps.

Algunos de los casos en los que se activa la política son los siguientes:

• Si un desarrollador de apps que accede a la API monetizada no compró una suscripción para el producto asociado de la API
• La cuenta del desarrollador no tiene saldo suficiente.
• El desarrollador superó el límite de volumen de transacciones.

Para obtener información sobre cómo adjuntar la política a tu proxy de API, consulta Aplica límites de monetización en proxies de API de forma forzosa.

Elemento <MonetizationLimitsCheck>

Especifica la política MonetizationLimitsCheck.

En la siguiente tabla, se proporciona una descripción de alto nivel de los elementos secundarios de <MonetizationLimitsCheck>.

El elemento <MonetizationLimitsCheck> usa la siguiente sintaxis:

<?xml version="1.0" encoding="UTF-8"?>
<MonetizationLimitsCheck async="false" continueOnError="false" enabled="true" name="POLICY_NAME">
    <DisplayName>DISPLAY_NAME</DisplayName>
    <IgnoreUnresolvedVariables>[true|false]</IgnoreUnresolvedVariables>
    <Variables>
        <Product>VARIABLE_NAME</Product>
    </Variables>
    <FaultResponse>
        <Set>
            <Payload contentType="text/xml">
                <error>
                    <messages>
                        <message>MESSAGE_TEXT</message>
                        <message>MESSAGE_TEXT</message>
                    </messages>
                </error>
            </Payload>
            <StatusCode>HTTP_STATUS</StatusCode>
            <ReasonPhrase>REASON_TEXT</ReasonPhrase>
        </Set>
    </FaultResponse>
</MonetizationLimitsCheck>

<?xml version="1.0" encoding="UTF-8"?>
<MonetizationLimitsCheck async="false" continueOnError="false" enabled="true" name="Monetization-Limits-Check">
    <DisplayName>Monetization Limits Check</DisplayName>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <Variables>
        <Product>myproductvar.name</Product>
    </Variables>
	<FaultResponse>
	        <Set>
	            <Payload contentType="text/xml">
	                <error>
	                    <messages>
	                        <message>Developer has reached usage quota</message>
	                        <message>Is Developer Suspended - {monetizationLimits.isDeveloperSuspended} </message>
	                    </messages>
	                </error>
	            </Payload>
	            <StatusCode>403</StatusCode>
	            <ReasonPhrase>Forbidden</ReasonPhrase>
	        </Set>
	</FaultResponse>
 </MonetizationLimitsCheck>

Este elemento tiene los siguientes atributos que son comunes a todas las políticas:

Referencia del elemento secundario

<DisplayName>

Se usan además del atributo name para etiquetar la política en el editor de proxy de la IU de administración con un nombre de lenguaje natural diferente.

El elemento <DisplayName> es común a todas las políticas.

El elemento <DisplayName> usa la siguiente sintaxis:

<PolicyElement>
  <DisplayName>policy_display_name</DisplayName>
  ...
</PolicyElement>

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

El elemento <DisplayName> no tiene atributos ni elementos secundarios.

<IgnoreUnresolvedVariables>

Determina si el procesamiento de la política debe detenerse cuando Apigee encuentra una variable sin resolver.

Para ignorar las variables sin resolver y continuar con el procesamiento, establece el valor en true; de lo contrario false. El valor predeterminado es true.

Establecer <IgnoreUnresolvedVariables> en true es diferente de establecer continueOnError del elemento <MonetizationLimitsCheck> en true. Si estableces continueOnError en true, Apigee ignora no solo los errores de las variables, sino todos los errores.

El elemento <IgnoreUnresolvedVariables> usa la siguiente sintaxis:

<IgnoreUnresolvedVariables>[true|false]</IgnoreUnresolvedVariables>

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

<Variables>

Especifica las variables de flujo de las que deseas recuperar los nombres de la entidad o el recurso durante la ejecución de la política.

Solo puedes especificar el <Product> elemento dentro del <Variables> elemento. Apigee obtiene el nombre del producto de API de la variable de flujo especificada en el elemento <Product>. Si no especificas el elemento <Variables>, Apigee obtiene de forma predeterminada el nombre del producto de API de la variable de contexto apiproduct.name. Cuando usa el nombre del producto de API, Apigee obtiene el plan de tarifas correspondiente para el producto y realiza la verificación de los límites de monetización.

El elemento <Variables> usa la siguiente sintaxis:

<Variables>
    <Product>VARIABLE_NAME</Product>
</Variables>

<Variables>
    <Product>myproductvar.name</Product>
</Variables>

<Product>

Especifica la variable que tiene el nombre del producto de API.

El elemento <Product> usa la siguiente sintaxis:

<Product>VARIABLE_NAME</Product>

<Product>myproductvar.name</Product>

<FaultResponse>

Define el mensaje de respuesta que se muestra al cliente solicitante si se genera una falla. Puedes personalizar los mensajes de respuesta según tus requisitos. Para obtener más información sobre el elemento y todos sus elementos secundarios, consulta FaultResponse.

Variables de flujo

Si estableces el atributo ContinueOnError del elemento <MonetizationLimitsCheck> como verdadero, no se genera ninguna falla. En este caso, las variables de flujo, mint.limitsViolated, mint.isDeveloperSuspended y mint.limitsPolicyError, se establecen automáticamente. Estas variables se pueden usar para realizar un manejo de excepciones adicional si es necesario.