Applicazione dei limiti di monetizzazione nei proxy API

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza documentazione di Apigee Edge.

Applica i limiti di monetizzazione associando i criteri ai proxy API associati a un prodotto API monetizzato, come descritto nelle sezioni seguenti.

Aggiunta di un criterio di autenticazione

La monetizzazione di Apigee utilizza la norma VerifyAPIKey o VerifyAccessToken per Determina se una richiesta in entrata è monetizzabile controllando il piano tariffario attivo pubblicato.

Collega il criterio VerifyAPIKey o VerifyAccessToken a un proxy API in uno dei seguenti modi:

• Quando crei un proxy API utilizzando la procedura guidata Crea proxy, seleziona Chiave API o OAuth 2.0 nella sezione Sicurezza: autorizzazione della pagina Criteri comuni. Ad esempio:

  

• Quando sviluppi un proxy API, allega il criterio VerifyAPIKey o VerifyAccessToken al flusso di richieste come primo criterio nel PreFlow del proxy API. Ad esempio:

  

Per ulteriori informazioni, vedi:

• Collegare un criterio a un flusso
• Verifica dei token di accesso
• Monitoraggio e debug del criterio di autenticazione utilizzando il debug

Applicazione degli abbonamenti degli sviluppatori ai prodotti API

Collega il criterio MonetizationLimitsCheck ai proxy API per applicare gli abbonamenti degli sviluppatori al prodotto API. In particolare, le norme sono viene attivata se lo sviluppatore di app che accede all'API non ha acquistato un abbonamento al prodotto API associato. In questo caso, la norma MonetizationLimitsCheck genera un errore e blocca la chiamata API.

Se non esiste un piano tariffario di monetizzazione per il prodotto API recuperato durante l'esecuzione della chiamata proxy, il prodotto viene considerato non monetizzato, la norma MonetizationLimitsCheck non recupera ulteriori dati e non ha alcun effetto.

Quando colleghi il criterio MonetizationLimitsCheck a un proxy API, le variabili di flusso mint.limitscheck.* e mint.subscription_* vengono compilate, come descritto in Eseguire il debug del criterio MonetizationLimitsCheck e nel riferimento alla variabile di flusso mint.

Nota: per impedire la fatturazione di transazioni specifiche, puoi utilizzare lo strumento transactionSuccess la variabile monetizzazione. Per ulteriori informazioni sull'utilizzo della variabile transactionSuccess, consulta la sezione Variabili di monetizzazione.

Collega la norma MonetizationLimitsCheck a un proxy API in uno dei seguenti modi:

• Quando crei un proxy API utilizzando la procedura guidata Crea proxy, seleziona Applica i limiti di monetizzazione nella pagina Criteri comuni, come mostrato nella figura seguente.

  

• Quando sviluppi un proxy API, collega MonetizationLimitsCheckPolicy al flusso di richieste nel proxy API PreFlow dopo il criterio VerifyAPIKey o VerifyAccessToken, come mostrato nella figura che segue.

  

Per ulteriori informazioni, vedi:

• Creazione di un proxy API
• Collegamento di un criterio a un flusso
• Debug della norma MonetizationLimitsCheck tramite Debug
• Norme relative a MonetizationLimitsCheck

Applicazione delle quote di monetizzazione nei proxy API

Nota: se aggiungi una quota dopo che il prodotto API è stato utilizzato, il calcolo della quota inizia dalla transazione monetizzata successiva.

Una quota definisce il numero di richieste consentite per un prodotto API in un determinato periodo di tempo. Per applicare le quote per la monetizzazione, ti consigliamo di impostare il valore della quota quando crei un prodotto API.

La definizione di un valore di quota per un prodotto API non applica automaticamente limitazioni al numero di chiamate che possono essere effettuate tramite il prodotto API. Devi anche aggiungere criteri per le quote ai proxy API a cui fa riferimento il prodotto API per assicurarti che il valore di quota definito Viene applicato in modo forzato il livello di prodotto API.

Collega il criterio per le quote a un proxy API in uno dei seguenti modi:

• Quando crei un proxy API utilizzando la procedura guidata Crea proxy, seleziona Imposta quote per app nella sezione Quote della pagina Criteri comuni, come mostrato nella figura seguente.

  

• Quando sviluppi un proxy API, collega il criterio Quota al flusso di richieste nel PreFlow del proxy API dopo il criterio VerifyAPIKey o VerifyAccessToken come mostrato nella figura che segue.

  

Modifica il criterio per le quote per abilitare L'elemento <UseQuotaConfigInAPIProduct> per Utilizza la configurazione della quota definita a livello di prodotto API.

Ad esempio:

<Quota continueOnError="false" enabled="true" name="impose-quota">
    <DisplayName>Impose Quota</DisplayName>
    <UseQuotaConfigInAPIProduct stepName="verify-api-key">
        <DefaultConfig>
            <Allow>10000</Allow>
            <Interval>1</Interval>
            <TimeUnit>week</TimeUnit>
        </DefaultConfig>
    </UseQuotaConfigInAPIProduct>
    <Distributed>true</Distributed>
    <Synchronous>true</Synchronous>
    <StartTime>2021-01-01 12:00:00</StartTime>
</Quota>

Note:

• Puoi definire la configurazione predefinita <DefaultConfig> da utilizzare se la configurazione della quota non è definita nella sezione prodotto API, ma la configurazione della quota definita a livello di prodotto API ha la precedenza.
• Quando aggiungi l'elemento <UseQuotaConfigInAPIProduct> al criterio per le quote, Apigee ignora qualsiasi Elementi secondari <Allow>, <Interval> e <TimeUnit> di <Quota>.

Quando colleghi il criterio di quota a un proxy API, le variabili di flusso ratelimit.* vengono compilate, come descritto in Eseguire il debug del criterio di quota e nelle variabili di flusso di riferimento del criterio di quota.

Per ulteriori informazioni, vedi:

• Collegamento di un criterio a un flusso
• Eseguire il debug del criterio Quota utilizzando Debug
• Criteri per le quote