Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Política MonetizationLimitsCheck

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

A política MonetizationLimitsCheck permite-lhe aplicar limites de rentabilização.

Especificamente, a política é acionada se o programador da app que acede à API rentabilizada não tiver comprado uma subscrição do produto API associado ou se o programador tiver um saldo insuficiente. Neste caso, a política MonetizationLimitsCheck gera uma falha e bloqueia uma chamada API. Para mais informações, consulte o artigo Aplicação de subscrições de programadores a produtos de API.

Quando anexa a política MonetizationLimitsCheck a um proxy de API, as variáveis de fluxo mint.limitscheck.* e mint.subscription_* são preenchidas, conforme descrito na referência da variável de fluxo mint.

Esta política é uma política extensível e a utilização desta política pode ter implicações de custo ou utilização, consoante a sua licença do Apigee. Para ver informações sobre os tipos de políticas e as implicações de utilização, consulte Tipos de políticas.

`<MonetizationLimitsCheck>`

Define a política MonetizationLimitsCheck.

Valor predefinido	N/A
Obrigatório?	Obrigatória
Tipo	Tipo complexo
Elemento principal	N/A
Elementos subordinados	`<DisplayName>` `<FaultResponse>` `<IgnoreUnresolvedVariables>`

A tabela seguinte apresenta uma descrição geral dos elementos subordinados de <MonetizationLimitsCheck>:

Elemento secundário	Obrigatório?	Descrição
`<DisplayName>`	Opcional	Um nome personalizado para a política.
`<FaultResponse>`	Opcional	Define a mensagem de resposta devolvida ao cliente que está a fazer o pedido.
`<IgnoreUnresolvedVariables>`	Opcional	Ignora qualquer erro de variável não resolvido no fluxo.

O elemento <MonetizationLimitsCheck> usa a seguinte sintaxe:

Sintaxe

<?xml version="1.0" encoding="UTF-8" standalone="no"?><MonetizationLimitsCheck continueOnError="[true|false]" enabled="[true|false]" name="policy_name">
   <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
   <FaultResponse>
        <AssignVariable>
          <Name/>
          <Value/>
        </AssignVariable>
        <Add>
            <Headers/>
        </Add>
        <Copy source="request">
            <Headers/>
            <StatusCode/>
       </Copy>
        <Remove>
            <Headers/>
        </Remove>
        <Set>
            <Headers/>
            <Payload/>
            <StatusCode/>
        </Set>
    </FaultResponse>
    <IgnoreUnresolvedVariables>VALUE</IgnoreUnresolvedVariables>
</MonetizationLimitsCheck>

Exemplo

No exemplo seguinte, se um programador não tiver comprado uma subscrição do produto API associado, o acesso à API rentabilizada é bloqueado e é devolvido um estado 403 com uma mensagem personalizada.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MonetizationLimitsCheck continueOnError="false" enabled="true" name="MonetizationLimitsCheck-1">
  <DisplayName>Monetization-Limits-Check-1</DisplayName>
  <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
  <FaultResponse>
    <Set>
      <Payload contentType="text/xml">
        <error>
          <messages>
            <message>Usage has been exceeded ({mint.limitscheck.isRequestBlocked}) or app developer has been suspended</message>
          </messages>
        </error>
      </Payload>
      <StatusCode>403</StatusCode>
    </Set>
  </FaultResponse>
</MonetizationLimitsCheck>

Este elemento tem os seguintes atributos comuns a todas as políticas:

Atributo	Predefinição	Obrigatório?	Descrição
`name`	N/A	Obrigatório	O nome interno da política. O valor do atributo `name` pode conter letras, números, espaços, hífenes, sublinhados e pontos finais. Este valor não pode exceder 255 carateres. Opcionalmente, use o elemento `<DisplayName>` para etiquetar a política no editor de proxy da IU de gestão com um nome diferente em linguagem natural.
`continueOnError`	falso	Opcional	Definido como `false` para devolver um erro quando uma política falha. Este comportamento é o esperado para a maioria das políticas. Definido como `true` para que a execução do fluxo continue mesmo depois de uma política falhar. Veja também: As regras de falhas são acionadas APENAS num estado de erro (acerca de continueOnError) Processar falhas no fluxo atual
`enabled`	verdadeiro	Opcional	Defina como `true` para aplicar a política. Defina como `false` para desativar a política. A política não é aplicada, mesmo que permaneça anexada a um fluxo.
`async`	falso	Descontinuado	Este atributo foi descontinuado.

Referência de elemento secundário

Esta secção descreve os elementos subordinados de <MonetizationLimitsCheck>.

`<DisplayName>`

Use em conjunto com o atributo name para etiquetar a política no editor de proxy da IU de gestão com um nome diferente e mais natural.

O elemento <DisplayName> é comum a todas as políticas.

Valor predefinido	N/A
Obrigatório?	Opcional. Se omitir `<DisplayName>`, é usado o valor do atributo `name` da política.
Tipo	String
Elemento principal	<`PolicyElement`>
Elementos subordinados	Nenhum

O elemento <DisplayName> usa a seguinte sintaxe:

Sintaxe

<PolicyElement>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  ...
</PolicyElement>

Exemplo

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

O elemento <DisplayName> não tem atributos nem elementos subordinados.

`<FaultResponse>`

Define a mensagem de resposta devolvida ao cliente que está a fazer o pedido. FaultResponse usa as mesmas definições que o elemento <FaultResponse> na política RaiseFault.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	Tipo complexo
Elemento principal	`<MonetizationLimitsCheck>`
Elementos subordinados	`<AssignVariable>` `<Add>` `<Copy>` `<Remove>` `<Set>`

`<AssignVariable>`

Atribui um valor a uma variável do fluxo de destino. Se a variável de fluxo não existir, o elemento AssignVariable cria-a.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	Tipo complexo
Elemento principal	`<FaultResponse>`
Elementos subordinados	`<Name>` `<Value>`

Por exemplo, use o código seguinte para definir a variável denominada myFaultVar na política MonetizationLimitsCheck:

<FaultResponse>
<AssignVariable>
  <Name>myFaultVar</Name>
  <Value>42</Value>
</AssignVariable>
</FaultResponse>

Em seguida, uma política numa regra de falha pode aceder à variável. Por exemplo, a seguinte política AssignMessage usa a variável para definir um cabeçalho na resposta de falha:

<AssignMessage enabled="true" name="Assign-Message-1">
<Add>
  <Headers>
    <Header name="newvar">{myFaultVar}</Header>
  </Headers>
</Add>
<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>
<AssignTo createNew="false" transport="http" type="response"/>
</AssignMessage>

<AssignVariable> na política MonetizationLimitsCheck usa a mesma sintaxe que o elemento <AssignVariable> na política AssignMessage.

`<Name>`

Nome da variável. Para mais informações, consulte o elemento Name no elemento AssignMessage.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	String
Elemento principal	`<AssignVariable>`
Elementos subordinados	Nenhum

`<Value>`

Valor da variável. Para mais informações, consulte o elemento Value na política AssignMessage.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	String
Elemento principal	`<AssignVariable>`
Elementos subordinados	Nenhum

`<Add>`

Adiciona cabeçalhos HTTP à mensagem de erro.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	Tipo complexo
Elemento principal	`<FaultResponse>`
Elementos subordinados	`<Headers>`

`<Headers>`

Especifica o cabeçalho HTTP a adicionar, definir, copiar ou remover.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	Tipo complexo
Elemento principal	`<Add>` `<Copy>` `<Remove>` `<Set>`
Elementos subordinados	Nenhum

Exemplos:

Adicionar cabeçalho

O exemplo seguinte copia o valor da variável de fluxo request.user.agent para o cabeçalho:

<Add>
    <Headers>
        <Header name="user-agent">{request.user.agent}</Header>
    </Headers>
</Add>

Definir cabeçalho

O exemplo seguinte define o cabeçalho user-agent para a variável de mensagem especificada com o elemento <AssignTo>.

<Set>
    <Headers>
        <Header name="user-agent">{request.header.user-agent}</Header>
    </Headers>
</Set>

Copiar cabeçalho – 1

O exemplo seguinte copia o headerA do pedido:

<Copy source='request'>
    <Headers>
        <Header name="headerA"/>
    </Headers>
</Copy>

Copiar cabeçalho – 2

O exemplo seguinte copia vários cabeçalhos:

<Copy source='request'>
    <Headers>
      <Header name="h1"/>
      <Header name="h2"/>
      <Header name="h3.2"/>
    </Headers>
</Copy>

Este exemplo copia "h1", "h2" e o segundo valor de "h3". Se "h3" tiver apenas um valor, "h3" não é copiado.

Remover cabeçalho - 1

O exemplo seguinte remove um cabeçalho:

<Remove>
    <Headers>
        <Header name="user-agent"/>
    </Headers>
</Remove>

Remover cabeçalho – 2

O exemplo seguinte remove vários cabeçalhos:

<Remove>
    <Headers>
      <Header name="h1"/>
      <Header name="h2"/>
      <Header name="h3.2"/>
    </Headers>
</Remove>

Este exemplo remove "h1", "h2" e o segundo valor de "h3". Se "h3" tiver apenas um valor, "h3" não é removido.

`<Copy>`

Copia informações de da mensagem especificada pelo atributo source para a mensagem de erro.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	Tipo complexo
Elemento principal	`<FaultResponse>`
Elementos subordinados	`<Headers>` `<StatusCode>`

A tabela seguinte descreve os atributos de <Copy>:

Atributo	Obrigatório?	Tipo	Descrição
fonte	Opcional	String	Especifica o objeto de origem da cópia. Se source não for especificado, é tratado como uma mensagem simples. Por exemplo, se a política estiver no fluxo de pedidos, a origem é predefinida para o objeto request. Se a política estiver no fluxo de resposta, é predefinida para o objeto response. Se omitir source, pode usar uma referência absoluta a uma variável de fluxo como a origem da cópia. Por exemplo, especifique o valor como {request.header.user-agent}. Se a variável de origem não puder ser resolvida ou for resolvida para um tipo que não seja de mensagem, o comando <Copy> não responde.

Atributo

Obrigatório?

Tipo

Descrição

fonte

Opcional

String

Especifica o objeto de origem da cópia.

Se source não for especificado, é tratado como uma mensagem simples. Por exemplo, se a política estiver no fluxo de pedidos, a origem é predefinida para o objeto request. Se a política estiver no fluxo de resposta, é predefinida para o objeto response. Se omitir source, pode usar uma referência absoluta a uma variável de fluxo como a origem da cópia. Por exemplo, especifique o valor como {request.header.user-agent}.
Se a variável de origem não puder ser resolvida ou for resolvida para um tipo que não seja de mensagem, o comando <Copy> não responde.

`<StatusCode>`

Especifica o código de estado HTTP na mensagem de erro. Pode copiar ou definir o valor de para o objeto especificado pelo atributo source.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	Tipo complexo
Elemento principal	`<Copy>` `<Set>`
Elementos subordinados	Nenhum

Exemplo:

Copie o código de estado

<Copy source='response'>
    <StatusCode>404</StatusCode>
</Copy>

Defina o código de estado

<Set source='request'>
    <StatusCode>404</StatusCode>
</Set>

`<Remove>`

Remove os cabeçalhos HTTP especificados da mensagem de erro. Para remover todos os cabeçalhos, especifique <Remove><Headers/></Remove>.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	Tipo complexo
Elemento principal	`<FaultResponse>`
Elementos subordinados	`<Headers>`

`<Set>`

Define informações na mensagem de erro.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	Tipo complexo
Elemento principal	`<FaultResponse>`
Elementos subordinados	`<Headers>` `<Payload>` `<StatusCode>`

`<Payload>`

Define o payload da mensagem de erro.

Valor predefinido	N/A
Obrigatório?	Opcional
Tipo	String
Elemento principal	`<Set>`
Elementos subordinados	Nenhum

Exemplos:

Defina o payload de texto

<Set>
    <Payload contentType="text/plain">test1234</Payload>
</Set>

Defina o payload JSON – 1

<Set>
    <Payload contentType="application/json">
        {"name":"foo", "type":"bar"}
    </Payload>
</Set>

Defina o payload JSON – 2

<Set>
    <Payload contentType="application/json" variablePrefix="@" variableSuffix="#">
        {"name":"foo", "type":"@variable_name#"}
    </Payload>
</Set>

Este exemplo insere variáveis usando os atributos variablePrefix e variableSuffix com carateres delimitadores.

Definir payload JSON – 3

<Set>
    <Payload contentType="application/json">
        {"name":"foo", "type":"{variable_name}"}
    </Payload>
</Set>

Este exemplo insere variáveis com chavetas. Pode usar chavetas a partir do lançamento de 16/08/17.

Defina o payload XML

<Set>
    <Payload contentType="text/xml">
        <root>
          <e1>sunday</e1>
          <e2>funday</e2>
          <e3>{var1}</e3>
    </Payload>
</Set>

Este exemplo insere variáveis com chavetas. Pode usar chavetas a partir do lançamento de 16/08/17.

`<IgnoreUnresolvedVariables>`

Determina se o processamento é interrompido quando é encontrada uma variável não resolvida.

Definido como true para ignorar as variáveis não resolvidas e continuar o processamento; caso contrário, false. O valor predefinido é true.

Definir <IgnoreUnresolvedVariables> como true é diferente de definir o <MonetizationLimitsCheck> de continueOnError como true. Se definir continueOnError como true, o Apigee ignora todos os erros, não apenas os erros nas variáveis.

O elemento <IgnoreUnresolvedVariables> usa a seguinte sintaxe:

Sintaxe

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

Exemplo

O exemplo seguinte define <IgnoreUnresolvedVariables> como false:

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

Códigos de erro

This section describes the fault codes and error messages that are returned and fault variables that are set by Apigee when this policy triggers an error. This information is important to know if you are developing fault rules to handle faults. To learn more, see What you need to know about policy errors and Handling faults.

Runtime errors

These errors can occur when the policy executes.

Fault code	HTTP status	Cause
`mint.service.subscription_not_found_for_developer`	`500`	This error occurs when a developer does not have a subscription to the API Product.
`mint.service.wallet_not_found_for_developer`	`500`	This error occurs when a prepaid developer attempts to consume a monetized API without maintaining a wallet for the currency specified in rate plan.
`mint.service.developer_usage_exceeds_balance`	`500`	This error occurs when a prepaid developer's usage exceeds the wallet balance.
`mint.service.wallet_blocked_due_to_inactivity`	`500`	This error occurs when a prepaid developer's wallet is not topped up in over 1.5 years and the developer attempts to consume an API.

Fault variables

Whenever there are execution errors in a policy, Apigee generates error messages. You can view these error messages in the error response. Many a time, system generated error messages might not be relevant in the context of your product. You might want to customize the error messages based on the type of error to make the messages more meaningful.

To customize the error messages, you can use either fault rules or the RaiseFault policy. For information about differences between fault rules and the RaiseFault policy, see FaultRules vs. the RaiseFault policy. You must check for conditions using the Condition element in both the fault rules and the RaiseFault policy. Apigee provides fault variables unique to each policy and the values of the fault variables are set when a policy triggers runtime errors. By using these variables, you can check for specific error conditions and take appropriate actions. For more information about checking error conditions, see Building conditions.

Variables	Where	Example
`fault.name`	The `fault.name` can match to any of the faults listed in the Runtime errors table. The fault name is the last part of the fault code.	`fault.name Matches "UnresolvedVariable"`
`MonetizationLimitsCheck.POLICY_NAME.failed`	`POLICY_NAME` is the user-specified name of the policy that threw the fault.	`MonetizationLimitsCheck.monetization-limits-check-1.failed = true`

For more information about policy errors, see What you need to know about policy errors

Variáveis de fluxo

As seguintes variáveis de fluxo predefinidas são preenchidas automaticamente quando a política MonetizationLimitsCheck é executada. Para mais informações, consulte as variáveis de fluxo mint.

Variável de fluxo	Descrição
`mint.limitscheck.is_request_blocked`	`true` para pedidos bloqueados.
`mint.limitscheck.is_subscription_found`	`true` se for encontrada uma subscrição da API.
`mint.limitscheck.purchased_product_name`	Nome do produto API comprado. Por exemplo: `MyProduct`.
`mint.limitscheck.status_message`	Mensagem de estado. Estes são os valores que podem ser devolvidos: `limits_check_success` - Verificação de limites bem-sucedida. `apiproduct_name_and_developer_email_not_available` - Não é possível determinar o programador da API nem o nome do produto da API para verificar os limites. `apiproduct_name_not_available` - Não é possível determinar o nome do produto da API para realizar a verificação de limites. `developer_email_not_available` - Não é possível determinar o email do programador da API para verificar os limites. `developer_usage_exceeds_balance` - O saldo pré-pago de programador é demasiado baixo. `rateplan_not_available` - Produto de API sem plano tarifário, sem falhas. `subscription_not_available` - O programador da API proprietário da app não tem uma subscrição. `wallet_disabled_due_to_inactivity` - O programador não usa a respetiva carteira há mais de um ano. Uma recarga de, pelo menos, uma unidade (em dólares, seria 0,01 USD) reativa-o. `wallet_not_found`: o programador não tem uma carteira. Isto pode acontecer quando não foi executado nenhum recarregamento para esse programador.
`mint.subscription_end_time_ms`	Hora de conclusão da subscrição do produto API.
`mint.subscription_start_time_ms`	Hora de início da subscrição do produto API. Por exemplo: `1618433956209`.

Política MonetizationLimitsCheck Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

<MonetizationLimitsCheck>

Sintaxe

Exemplo

Referência de elemento secundário

<DisplayName>

Sintaxe

Exemplo

<FaultResponse>

<AssignVariable>

<Name>

<Value>

<Add>

<Headers>

Adicionar cabeçalho

Definir cabeçalho

Copiar cabeçalho – 1

Copiar cabeçalho – 2

Remover cabeçalho - 1

Remover cabeçalho – 2

<Copy>

<StatusCode>

Copie o código de estado

Defina o código de estado

<Remove>

<Set>

<Payload>

Defina o payload de texto

Defina o payload JSON – 1

Defina o payload JSON – 2

Definir payload JSON – 3

Defina o payload XML

<IgnoreUnresolvedVariables>

Sintaxe

Exemplo

Códigos de erro

Runtime errors

Fault variables

Variáveis de fluxo

Política MonetizationLimitsCheck

`<MonetizationLimitsCheck>`

`<DisplayName>`

`<FaultResponse>`

`<AssignVariable>`

`<Name>`

`<Value>`

`<Add>`

`<Headers>`

`<Copy>`

`<StatusCode>`

`<Remove>`

`<Set>`

`<Payload>`

`<IgnoreUnresolvedVariables>`