Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Questo argomento fornisce informazioni e indicazioni per la risoluzione dei problemi di monetizzazione più comuni.
Sviluppatore sospeso
Sintomo
Lo sviluppatore è stato sospeso e non potrà effettuare altre transazioni di monetizzazione o chiamate API.
Messaggi di errore
<error> <messages> <message>Exceeded developer limit configuration -</message> <message>Is Developer Suspended - true</message> </messages> </error>
Diagnostica
Per determinare il motivo per cui lo sviluppatore è stato sospeso, svolgi i passaggi che seguono:
- Esegui la seguente chiamata API per identificare il codice di errore associato allo sviluppatore sospeso:
- Se sei un utente del cloud pubblico, utilizza l'API seguente:
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
- Se sei un utente Private Cloud, utilizza l'API seguente:
curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
- Se sei un utente del cloud pubblico, utilizza l'API seguente:
- Confronta il codice di errore con i seguenti codici dei motivi per determinare il motivo della sospensione dello sviluppatore.
Vedi anche: Riepilogo dei codici motivo per gli sviluppatori sospesi
Codice motivo |
Causa |
Dettagli |
INSUFFICIENT_FUNDS |
Il saldo dell'account sviluppatore è esaurito |
Se il saldo prepagato dell'account sviluppatore non dispone di fondi sufficienti per eventuali transazioni aggiuntive, lo sviluppatore verrà sospeso. Per gli sviluppatori con pagamento posticipato, questo errore può verificarsi se superano il massimale di credito o se il massimale di credito impostato nella valuta utilizzata è esaurito. |
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED |
Lo sviluppatore non può effettuare ulteriori transazioni |
Ogni sviluppatore può effettuare un numero fisso di transazioni in base al piano tariffario acquistato. Se il numero di transazioni viene superato, lo sviluppatore viene sospeso e non può completare ulteriori transazioni. |
NO_CURRENT_PUBLISHABLE_ENTITY |
Lo sviluppatore non ha acquistato alcun piano tariffario |
Uno sviluppatore è tenuto ad acquistare un piano tariffario prima di completare qualsiasi transazione. |
Risoluzione
Errore |
Procedura per la risoluzione |
INSUFFICIENT_FUNDS |
Lo sviluppatore deve assicurarsi che il saldo dell'account o il credito disponibile sia sufficiente per completare eventuali transazioni aggiuntive. |
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED |
|
NO_CURRENT_PUBLISHABLE_ENTITY |
Lo sviluppatore deve acquistare un piano tariffario per poter effettuare chiamate API. |
Problemi di configurazione della monetizzazione
Sintomi
I problemi di configurazione della monetizzazione possono manifestarsi con diversi sintomi, tra cui:
- Funzionalità webhook non funzionante
- Impossibile creare webhook
- Notifiche webhook non attivate
- I report sulla monetizzazione non mostrano alcuna transazione. Ad esempio, i dati di Analytics indicano che lo sviluppatore ha completato molte transazioni in un determinato periodo di tempo, ma nei report Monetizzazione non viene elencata nessuna di queste transazioni.
- Le transazioni non vengono registrate
Messaggi di errore
Potresti non notare alcun messaggio di errore, ma vedrai i problemi come spiegato nella sezione Sintomi.
Possibili cause
Se noti uno dei sintomi elencati nella sezione Sintomi, è molto probabile che le transazioni non vengano monetizzate.
Diagnosi della causa
-
Utilizza la chiamata API di gestione descritta nella seguente sezione per verificare se le transazioni vengono monetizzate.
- Se nessuna transazione viene elencata come SUCCESS nella durata specificata, significa che le transazioni non sono monetizzate.
Le cause tipiche della mancata monetizzazione delle transazioni sono:
- Norme sul controllo dei limiti di monetizzazione non collegate al proxy API
- APIProduct non è monetizzato
- Criterio di registrazione delle transazioni definito in modo errato
- Lo sviluppatore non ha acquistato un piano tariffario
Le seguenti sezioni descrivono come diagnosticare e risolvere ciascun problema.
Norme sul controllo dei limiti di monetizzazione non utilizzate nel proxy API
Diagnostica
- Verifica se le norme sul controllo dei limiti di monetizzazione sono collegate ai proxy API.
- Se il criterio non è associato, questo potrebbe essere il motivo per cui le transazioni sono indicate come FAILED.
Risoluzione
Allega le norme sul controllo dei limiti di monetizzazione ai proxy API richiesti, come descritto in Applicare i limiti di monetizzazione sui proxy API.
Se il problema persiste, controlla Il prodotto API non è monetizzato.
Il prodotto API non è monetizzato
Diagnostica
- Controlla se il prodotto API è monetizzato (solo i prodotti API monetizzati sono valutati e saranno elencati nelle transazioni). Per prodotto monetizzato è disponibile almeno un piano tariffario attivo.
- Utilizza la seguente chiamata API di gestione per ottenere l'elenco dei prodotti API monetizzati:
- Se sei un utente del cloud pubblico, utilizza l'API seguente:
curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
- Se sei un utente Private Cloud, utilizza l'API seguente:
curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
- Se sei un utente del cloud pubblico, utilizza l'API seguente:
- Se il prodotto API associato al proxy API non è monetizzato, questo potrebbe essere il motivo per cui le transazioni non vengono monetizzate.
Risoluzione
Per monetizzare un prodotto API, segui questi passaggi:
- Configura il criterio di registrazione delle transazioni.
- Verifica che il prodotto API abbia un piano tariffario attivo.
Se il problema persiste, consulta la sezione Norme di registrazione delle transazioni definite in modo errato.
Norme di registrazione delle transazioni definite in modo errato
Diagnostica
- Abilita la traccia UI per il proxy API a cui sono allegate le norme sul controllo dei limiti di monetizzazione.
- Seleziona una richiesta API specifica dalla traccia UI.
- Seleziona il flusso AX di Analytics e verifica se le seguenti variabili di flusso di monetizzazione (mint)
hanno i valori corretti:
mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'. mint.tx.app_id - Application id of API product. mint.tx.prod_id - API product id.
Di seguito è riportata una traccia UI di esempio che mostra che le variabili di flusso del mint sono configurate correttamente.
- Se noti un errore nella variabile
mint.tx.status
, significa che il criterio di registrazione delle transazioni non è definito correttamente.
Risoluzione
- Assicurati di aver seguito correttamente tutti i passaggi documentati in Creare il criterio di registrazione delle transazioni durante la creazione del criterio di registrazione delle transazioni.
- Il valore chiave è il "criterio di esito positivo delle transazioni" impostato nel criterio di registrazione delle transazioni. Consulta la sezione Esempi di impostazione dei criteri di esito positivo delle transazioni in un criterio di registrazione delle transazioni
Lo sviluppatore non ha acquistato il piano tariffario
Diagnostica
- Utilizza la seguente chiamata API di gestione per verificare i piani tariffari acquistati dallo sviluppatore:
- Se sei un utente del cloud pubblico, utilizza l'API seguente:
curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
- Se sei un utente di Private Cloud, utilizza l'API seguente:
curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
- Se sei un utente del cloud pubblico, utilizza l'API seguente:
- In base alla risposta alla chiamata precedente, trova il piano che era attivo nel momento in cui la transazione è stata completata dallo sviluppatore.
Risoluzione
Lo sviluppatore deve acquistare il piano tariffario in base ai suoi requisiti ed eseguire le transazioni/le API.
Se il problema persiste, contatta l'assistenza Apigee Edge.