Política MonetizationLimitsCheck

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X. información

Descripción general

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

Estos son algunos de los casos en los que se activa la política:

• Si un desarrollador de apps que accede a la API monetizada no compró una suscripción a el producto de API asociado
• 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 los proxies de API.

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> como true no es lo mismo que establecer el elemento <MonetizationLimitsCheck> De continueOnError a true. Si configuras continueOnError como true, Apigee ignora lo siguiente: solo los errores de variable pero todos los errores.

El elemento <IgnoreUnresolvedVariables> usa la siguiente sintaxis:

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

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

<Variables>

Especifica las variables de flujo desde las que quieres recuperar el de entidades o recursos durante la ejecución de la política.

Solo puedes especificar el elemento <Product> dentro del elemento <Variables>. Apigee obtiene Es el nombre del producto de la API a partir de la variable de flujo especificada en el elemento <Product>. Si no especifiques el elemento <Variables>, Apigee obtiene, de forma predeterminada, el nombre del producto de API del Variable de contexto apiproduct.name. Cuando usas el nombre del producto de API, Apigee obtiene el plan de tarifas correspondiente del 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 produce una falla. Puedes personalizar la respuesta mensajes según tus requisitos. Para obtener más información sobre el y todos sus elementos secundarios, consulta FaultResponse.

Variables de flujo

Si configuras el atributo <MonetizationLimitsCheck> ContinueOnError como verdadero, no se genera ningún error. En este caso, el de flujo, mint.limitsViolated, mint.isDeveloperSuspended y Las mint.limitsPolicyError se configuran automáticamente. Estas variables se pueden usar para realizar más control de excepciones si es necesario.