Dépannage des problèmes de monétisation

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X. info

Cette rubrique fournit des informations et des conseils sur la résolution des problèmes de monétisation courants.

Développeur suspendu

Problème constaté

Le développeur est suspendu et ne pourra plus effectuer de transactions de monétisation ni d'appels d'API.

Messages d'erreur

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

Diagnostic

Pour déterminer la raison de la suspension du développeur, procédez comme suit :

1. Exécutez l'appel d'API suivant pour identifier le code d'erreur associé au développeur suspendu :
   1. Si vous êtes un utilisateur de Public Cloud, utilisez l'API ci-dessous :

      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

   2. Si vous êtes un utilisateur de Private Cloud, utilisez l'API ci-dessous :

      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

2. Comparez le code d'erreur avec les codes de motif suivants pour déterminer pourquoi le développeur a été suspendu.

Voir aussi : Résumé des codes de motif pour les développeurs suspendus

Solution

Problèmes de configuration de la monétisation

Symptômes

Les problèmes de configuration de la monétisation peuvent se manifester par différents symptômes, tels que :

• La fonctionnalité des webhooks ne fonctionne pas
• Impossible de créer des webhooks
• Les notifications de webhook ne sont pas déclenchées
• Les rapports de monétisation n'affichent aucune transaction. Par exemple, les données Analytics indiquent que le développeur a effectué de nombreuses transactions sur une période spécifique, mais les rapports de monétisation n'en listent aucune.
• Les transactions ne sont pas enregistrées

Messages d'erreur

Vous ne verrez peut-être aucun message d'erreur, mais vous constaterez les problèmes expliqués dans la section Symptômes.

Causes possibles :

Si vous constatez l'un des symptômes listés dans la section Symptômes, il est très probable que les transactions ne soient pas monétisées.

Diagnostiquer la cause

1. Utilisez l'appel d'API de gestion décrit dans la section suivante pour vérifier si les transactions sont monétisées.

   Afficher l'état des transactions

2. Si aucune transaction n'est listée comme RÉUSSIE dans la durée spécifiée, cela signifie qu'elles ne sont pas monétisées.

Les causes typiques de la non-monétisation des transactions sont les suivantes :

• La règle Monetization Limits Check n'est pas associée au proxy d'API
• L'APIProduct n'est pas monétisé
• La règle d'enregistrement des transactions est mal définie
• Le développeur n'a pas acheté de plan tarifaire

Les sections suivantes décrivent comment diagnostiquer et résoudre chaque problème.

La règle Monetization Limits Check n'est pas utilisée dans le proxy d'API

Diagnostic

1. Vérifiez si la règle Monetization Limits Check est associée aux proxys d'API.
2. Si la règle n'est pas associée, cela peut être la raison pour laquelle les transactions sont listées comme ÉCHOUÉES.

Solution

Associez la règle Monetization Limits Check aux proxys d'API requis, comme décrit dans Appliquer des limites de monétisation aux proxys d'API.

Si le problème persiste, consultez la section L'APIProduct n'est pas monétisé.

L'APIProduct n'est pas monétisé

Diagnostic

1. Vérifiez si le produit d'API est monétisé (seuls les produits d'API monétisés sont évalués et seront listés dans les transactions). Un produit monétisé est un produit qui dispose d'au moins un plan tarifaire actif disponible.
2. Utilisez l'appel d'API de gestion suivant pour obtenir la liste des produits d'API monétisés :
   1. Si vous êtes un utilisateur de Public Cloud, utilisez l'API ci-dessous :

      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password

   2. Si vous êtes un utilisateur de Private Cloud, utilisez l'API ci-dessous :

      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password

3. Si le produit d'API associé à votre proxy d'API n'est pas monétisé, cela peut être la raison pour laquelle les transactions ne sont pas monétisées.

Solution

Pour monétiser un produit d'API, procédez comme suit :

1. Configurez la règle d'enregistrement des transactions.

2. Vérifiez que le produit d'API dispose d'un plan tarifaire actif.

Si le problème persiste, consultez la section La règle d'enregistrement des transactions est mal définie.

La règle d'enregistrement des transactions est mal définie

Diagnostic

1. Activez le traçage de l'interface utilisateur pour le proxy d'API auquel la règle Monetization Limits Check est associée.
2. Sélectionnez une requête API spécifique dans le traçage de l'interface utilisateur.
3. Sélectionnez le flux Analytics AX et vérifiez si les variables de flux de monétisation (mint) flow suivantes ont les valeurs appropriées :

   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.

4. Voici un exemple de traçage de l'interface utilisateur qui montre que les variables de flux de monétisation sont correctement configurées.

   

5. Si vous constatez une erreur dans la variable mint.tx.status, cela indique que la règle d'enregistrement des transactions est mal définie.

Solution

1. Assurez-vous que toutes les étapes décrites dans Créer une règle d'enregistrement des transactions ont été suivies correctement lors de la création de la règle d'enregistrement des transactions.
2. La valeur clé correspond aux "critères de réussite de la transaction" définis dans la règle d'enregistrement des transactions. Consultez la section Exemples de définition de critères de réussite de transaction dans une règle d'enregistrement des transactions.

Le développeur n'a pas acheté de plan tarifaire

Diagnostic

1. Utilisez l'appel d'API de gestion suivant pour vérifier les plans tarifaires achetés par le développeur :
   1. Si vous êtes un utilisateur de Public Cloud, utilisez l'API ci-dessous :

      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

   2. Si vous êtes un utilisateur de Private Cloud, utilisez l'API ci-dessous :

      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

2. En fonction de la réponse de l'appel ci-dessus, recherchez le plan qui était actif au moment où la transaction a été effectuée par le développeur.

Solution

Le développeur doit acheter le plan tarifaire en fonction de ses besoins, puis exécuter les transactions/API.

Si le problème persiste, contactez l'assistance Apigee Edge.