Dépannage des problèmes de monétisation

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X.
En savoir plus

Cet article fournit des informations et des conseils pour résoudre les problèmes de monétisation couramment observés. des problèmes.

Développeur suspendu

Symptôme

Le développeur est suspendu et ne peut plus monétiser ses contenus. des transactions/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 pour laquelle un développeur a été suspendu, procédez comme suit : étapes:

  1. Exécutez l'appel d'API suivant pour identifier le code d'erreur associé au compte suspendu développeur: <ph type="x-smartling-placeholder">
      </ph>
    1. Si vous êtes un utilisateur de cloud public, 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 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 la raison pour laquelle le développeur suspendue.

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

Code explicatif

Cause

Détails

FONDS_INSUFFISANTS

Le solde du compte de développeur est épuisé

Si le solde prépayé du compte de développeur est insuffisant pour couvrir transactions, le compte du développeur sera suspendu.

Pour les développeurs de post-paiement, cette erreur peut se produire s'ils dépassent leur limite de crédit ou si la limite de crédit définie dans la devise utilisée est épuisée.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

Le Développeur n'est plus en mesure d'effectuer d'autres transactions

Chaque développeur est autorisé à effectuer un nombre fixe de transactions en fonction du tarif souscrit. Si le nombre de transactions est dépassé, le développeur est suspendu et ne peut pas effectuer d'autres transactions.

NO_CURRENT_PUBLISHABLE_ENTITY

Le développeur n'a acheté aucun forfait

Un développeur doit souscrire un plan tarifaire avant d'effectuer toute transaction.

Solution

Erreur

Procédure de résolution

FONDS_INSUFFISANTS

Le développeur doit s'assurer que le solde de son compte est suffisant ou disponible pour effectuer d'autres transactions.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

  1. Effectuez les appels d'API suivants pour obtenir le forfait développeur et les détails de la transaction, respectivement: <ph type="x-smartling-placeholder">
      </ph>
    • Exécutez l'appel d'API suivant pour obtenir les dates de début et de fin les forfaits souscrits par le développeur:
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
      
    • Exécutez l'appel d'API suivant pour obtenir le nombre d'appels transactions effectuées par le développeur:
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D
      
  2. Dans l'interface utilisateur Edge, vous pouvez également vérifier le nombre d'appels qu'un développeur que vous pouvez effectuer en sélectionnant:

    Colis > NomPackage > RatePlanName > Tableau des tarifs

    Par exemple, si le nom du package est Pro Package et qu'il est un forfait sans frais, le chemin est le suivant:

    Colis > Package Pro > Forfait sans frais > Tableau des tarifs

NO_CURRENT_PUBLISHABLE_ENTITY

Le développeur doit acheter un plan tarifaire pour pouvoir effectuer des appels d'API.

Problèmes de configuration de la monétisation

Symptômes

Les problèmes de configuration de la monétisation peuvent se manifester sous différentes formes:

  • Les webhooks ne fonctionnent pas
  • Impossible de créer des webhooks
  • Les notifications de webhook ne sont pas déclenchées
  • Les rapports sur la monétisation n'affichent aucune transaction. Par exemple : les données Analytics indiquent que le développeur a réalisé de nombreuses des transactions sur une période donnée, mais les rapports sur la monétisation ne répertorie aucune de ces transactions.
  • Les transactions ne sont pas enregistrées

Messages d'erreur

Il est possible qu'aucun message d'erreur ne s'affiche, mais les problèmes se produisent expliqué dans la section Symptômes .

Causes possibles :

Si vous constatez l'un des symptômes répertoriés dans l'article Symptômes, c'est il est très probable que les transactions ne sont pas monétisées.

Identification de 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.

    <ph type="x-smartling-placeholder"></ph> Afficher l'état des transactions

  2. Si aucune transaction n'est listée comme SUCCESS pendant la durée spécifiée, les transactions ne sont pas monétisées.

Voici quelques raisons courantes pour lesquelles les transactions ne sont pas monétisées:

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

Règle de vérification des limites de monétisation non utilisée dans le proxy d'API

Diagnostic

  1. Vérifiez si la règle de vérification des limites de monétisation est associée aux proxys d'API.
  2. Si la règle n'est pas jointe, il est possible que les transactions soient listées en tant que FAILED.

Solution

associer la règle de vérification des limites de monétisation aux proxys d'API requis ; comme décrit dans <ph type="x-smartling-placeholder"></ph> Appliquer des limites de monétisation sur les proxys d'API

Si le problème persiste, vérifiez l'état . Le produit d'API n'est pas monétisé.

Le produit d'API n'est pas monétisé

Diagnostic

  1. Vérifiez si le produit API est monétisé (seuls les produits d'API monétisés sont évalués et sous "Transactions"). Un produit monétisé est un produit avec au moins un plan tarifaire actif disponibles.
  2. Utilisez l'appel d'API de gestion suivant pour obtenir la liste des produits d'API monétisés: <ph type="x-smartling-placeholder">
      </ph>
    1. Si vous êtes un utilisateur de cloud public, 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 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é, il peut s'agir 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. <ph type="x-smartling-placeholder"></ph> Configurer 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, vérifiez <ph type="x-smartling-placeholder"></ph> Règle d'enregistrement des transactions définie de manière incorrecte.

Règle d'enregistrement des transactions définie de manière incorrecte

Diagnostic

  1. Activer la trace de l'interface utilisateur pour le proxy d'API soumis à la règle de vérification des limites de monétisation joint.
  2. Sélectionnez une requête API particulière dans la trace de l'interface utilisateur.
  3. Sélectionnez le flux AX Analytics et vérifiez si les paramètres de monétisation suivants (menthe) les variables de flux 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 trace d'UI qui montre que les variables de flux Mint sont correctement configurées.

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

Solution

  1. Assurez-vous que toutes les étapes décrites dans <ph type="x-smartling-placeholder"></ph> Créer une règle d'enregistrement des transactions a été correctement suivi lors de la création de la règle d'enregistrement des transactions.
  2. La clé-valeur correspond aux "critères de réussite de la transaction" définis dans la règle d'enregistrement des transactions. Voir <ph type="x-smartling-placeholder"></ph> Exemples de définition de critères de réussite de transaction dans une règle d'enregistrement des transactions

Développeur n'a pas souscrit de forfait

Diagnostic

  1. Utilisez l'appel d'API de gestion suivant pour vérifier les plans tarifaires achetés par le développeur: <ph type="x-smartling-placeholder">
      </ph>
    1. Si vous êtes un utilisateur de cloud public, 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 vous basant sur la réponse à l'appel ci-dessus, trouvez le forfait qui était actif au moment la transaction a été effectuée par le développeur.

Solution

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

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