Questa pagina si applica a Apigee e Apigee ibridi.
Visualizza la documentazione di Apigee Edge.
Esegui il debug della monetizzazione utilizzando il debug come descritto nelle sezioni seguenti.
Debug della fase dei criteri di autenticazione
La monetizzazione di Apigee utilizza il criterio VerifyAPIKey o VerifyAccessToken per determinare se una richiesta in arrivo è monetizzabile controllando il piano tariffario pubblicato attivo. Per ulteriori informazioni sull'aggiunta di un criterio, consulta la sezione Aggiunta di un criterio di autenticazione.
Ad esempio, l'immagine seguente mostra i dettagli della fase del criterio VerifyAPIKey nel flusso di richiesta.
Dopo l'autenticazione dell'utente, il criterio VerifyAPIKey controlla tutti i piani tariffari pubblicati per determinare quale, se presente, è attivo in base ai relativi tempi di attivazione e scadenza. Se viene trovato un piano tariffario pubblicato attivo, vengono compilate le seguenti variabili di flusso:
Variabile di flusso | Impostazione |
---|---|
mint.mintng_is_apiproduct_monetized |
true se viene trovato un piano tariffario pubblicato attivo. |
mint.mintng_rate_plan_id |
ID piano tariffario. |
mint.rateplan_end_time_ms |
Data e ora di scadenza del piano tariffario. Ad esempio: 1619433556408 |
mint.rateplan_start_time_ms |
Ora di attivazione del piano tariffario. Ad esempio: 1618433956209 |
Se non viene trovato alcun piano tariffario pubblicato attivo, la variabile di flusso mint.mintng_is_apiproduct_monetized
viene impostata su false
e le variabili di flusso aggiuntive non vengono compilate.
Per ulteriori informazioni, consulta le variabili di flusso mint.
Debug della fase di verifica delle norme MonetizationLimitsCheck
La monetizzazione di Apigee utilizza il criterio MonetizationLimitsCheck per applicare gli abbonamenti degli sviluppatori al prodotto API. Per maggiori informazioni sull'aggiunta di queste norme, consulta la sezione Applicare gli abbonamenti degli sviluppatori ai prodotti API.
Ad esempio, l'immagine seguente mostra i dettagli della fase delle norme MonetizationLimitsCheck nel flusso di richiesta.
Se lo sviluppatore ha acquistato un abbonamento al prodotto API, vengono compilate le seguenti variabili di flusso:
Variabile di flusso | Descrizione |
---|---|
mint.limitscheck.is_request_blocked |
true per le richieste bloccate. |
mint.limitscheck.is_subscription_found |
true se viene trovato un abbonamento API. |
mint.limitscheck_purchased_product_name |
Nome del prodotto API acquistato. Ad esempio: MyProduct |
mint.limitscheck.status_message |
Messaggio di stato. Ad esempio: limits_check_success |
mint.prepaid_developer_balance |
Saldo corrente nel portafoglio dell'account prepagato dello sviluppatore associato alla valuta del piano tariffario. |
mint.prepaid_developer_currency |
Valuta del saldo disponibile nella variabile
mint.prepaid_developer_balance . |
mint.subscription_end_time_ms |
Ora di fine dell'abbonamento al prodotto API. |
mint.subscription_start_time_ms |
Data/ora di inizio dell'abbonamento al prodotto API. Ad esempio: 1618433956209 |
Se lo sviluppatore non ha acquistato un abbonamento al prodotto API:
- La variabile di flusso
mint.limitscheck_is_subscription_found
è impostata sufalse
mint.limitscheck.is_request_blocked
è impostato sutrue
- Nessun'altra variabile di flusso viene compilata.
Per ulteriori informazioni, consulta le variabili di flusso mint.
Debug della fase dei criteri di quota
La monetizzazione Apigee utilizza i criteri per le quote per applicare le quote definite a livello di prodotto API. Le quote definiscono il numero di richieste consentite per un prodotto API in un determinato periodo di tempo. Per scoprire di più sull'aggiunta delle norme, consulta l'articolo Applicazione delle quote di monetizzazione nei proxy API.
Ad esempio, l'immagine seguente mostra i dettagli della fase del criterio per le quote nel flusso di richiesta in cui è stata superata la quota.
In questo esempio la quota è stata superata, viene restituito uno stato 429 Too Many Requests
HTTP e il flusso ratelimit.*
del flusso
vengono compilate per fornire ulteriori dettagli sull'eccezione di quota. Per una descrizione di ratelimit.*
, consulta le variabili di flusso dei criteri per le quote.
Debug della fase del criterio DataCapture
Apigee utilizza le variabili di monetizzazione acquisite dal criterio DataCapture per la classificazione, il calcolo della quota di condivisione delle entrate e l'analisi. Per ulteriori informazioni sull'acquisizione delle variabili di monetizzazione nel criterio, consulta Acquisire i dati sulla monetizzazione.
Ad esempio, l'immagine seguente mostra i dettagli della fase di esecuzione del criterio DataCapture nel flusso di risposta.
Se non si verificano errori durante l'acquisizione delle variabili di monetizzazione, per una transazione vengono completate le seguenti variabili di flusso:
Variabile di flusso | Descrizione |
---|---|
mint.mintng_currency |
Valuta per il calcolo delle entrate. Questa variabile di flusso ha il valore della variabile di monetizzazione |
mint.mintng_price |
Entrate per il calcolo della quota dello sviluppatore. Questa variabile di flusso ha il valore della variabile di monetizzazione |
mint.mintng_price_multiplier |
Fattore (moltiplicatore) per cui viene moltiplicato il costo per transazione. Questa variabile di flusso ha il valore della variabile di monetizzazione |
mint.mintng_tx_success |
Specifica se la transazione è monetizzata. Questa variabile di flusso ha il valore della variabile di monetizzazione |
Debug della fase di esecuzione del proxy API monetizzato
Dopo la corretta esecuzione del proxy API monetizzato, viene compilato un insieme di variabili di flusso con informazioni sulle tariffe e le commissioni basate sul consumo della monetizzazione.
Ad esempio, l'immagine seguente mostra i dettagli della fase di Esecuzione del proxy nel flusso PostClient in cui vengono completate le variabili.
Se l'esecuzione del proxy dell'API monetizzata va a buon fine, le seguenti variabili di flusso vengono completate:
Variabile di flusso | Descrizione |
---|---|
message.status.code |
Codice di stato HTTP del messaggio di risposta dalla destinazione.
Se la risposta include criteri, il valore di questa variabile è sovrascritto dal codice di stato restituito dal criterio. |
mint.limitscheck.is_request_blocked |
Flag che specifica se la richiesta API è bloccata. |
mint.mintng_consumption_pricing_rates |
Commissioni basate sul consumo impostate nel piano tariffario. |
mint.mintng_consumption_pricing_type |
Tipo di prezzo basato sul consumo impostato nel piano tariffario. Ad esempio: FIXED_PER_UNIT |
mint.mintng_dev_share |
Le entrate da condividere con lo sviluppatore. |
mint.mintng_price_multiplier |
Fattore (moltiplicatore) acquisito dal criterio DataCapture. Il costo per transazione è moltiplicato per questo fattore. |
mint.mintng_rate |
Tariffa addebitata per la chiamata API. |
mint.mintng_rate_before_multipliers |
Tariffa addebitata per la chiamata API senza il calcolo di perUnitPriceMultiplier . |
mint.mintng_revenue_share_rates |
Percentuali relative alla quota di condivisione delle entrate impostate nel piano tariffario. |
mint.mintng_revenue_share_type |
Tipo di quota di condivisione delle entrate impostata nel piano tariffario. |
mint.prepaid_updated_developer_usage |
Utilizzo corrente dello sviluppatore prepagato. |
mint.status |
Stato della chiamata monetizzata. Compilato solo in caso di errore. |
mint.status_code |
Codice di stato HTTP della chiamata monetizzata. Viene compilato solo in caso di errore. |
mint.tx_success_result |
Indica se la monetizzazione è andata a buon fine per la transazione. |
Per una descrizione dettagliata di tutte le variabili, consulta Voci del flusso di Mint.