Fehlerbehebung bei Problemen mit der Monetarisierung

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Hier finden Sie Informationen und Anleitungen zur Behebung häufig auftretender Probleme bei der Monetarisierung.

Entwickler gesperrt

Symptom

Der Entwickler ist gesperrt und kann keine weiteren Monetarisierungstransaktionen und API-Aufrufe durchführen.

Fehlermeldungen

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

Diagnose

So kannst du herausfinden, warum der Entwickler gesperrt wurde:

  1. Führen Sie den folgenden API-Aufruf aus, um den Fehlercode für den gesperrten Entwickler zu ermitteln:
    1. Wenn Sie Nutzer einer öffentlichen Cloud sind, verwenden Sie die folgende API:
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
      
    2. Wenn Sie ein Private Cloud-Nutzer sind, verwenden Sie die folgende API:
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
      
  2. Vergleichen Sie den Fehlercode mit den folgenden Ursachencodes, um zu ermitteln, warum der Entwickler gesperrt wurde.

Siehe auch: Zusammenfassung der Ursachencodes für gesperrte Entwickler

Ursachencode

Ursache

Details

INSUFFICIENT_FUNDS

Guthaben des Entwicklerkontos ist aufgebraucht

Wenn das vorausbezahlte Guthaben auf dem Entwicklerkonto für weitere Transaktionen nicht ausreicht, wird der Entwickler gesperrt.

Für Entwickler mit nachträglicher Zahlung kann dieser Fehler auftreten, wenn sie ihr Kreditlimit überschreiten oder das für die verwendete Währung festgelegte Kreditlimit erschöpft ist.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

Der Entwickler kann keine weiteren Transaktionen vornehmen

Jeder Entwickler kann eine feste Anzahl von Transaktionen basierend auf dem erworbenen Preisplan vornehmen. Wenn die Anzahl der Transaktionen überschritten wird, wird der Entwickler gesperrt und kann keine weiteren Transaktionen ausführen.

NO_CURRENT_PUBLISHABLE_ENTITY

Der Entwickler hat keinen Preisplan erworben

Ein Entwickler muss einen Preisplan erwerben, bevor er Transaktionen ausführen kann.

Auflösung

Fehler

Schritte zur Problemlösung

INSUFFICIENT_FUNDS

Der Entwickler muss dafür sorgen, dass ein ausreichendes Guthaben vorhanden ist, um weitere Transaktionen ausführen zu können.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

  1. Mit den folgenden API-Aufrufen kannst du den Preisplan für Entwickler und die Transaktionsdetails abrufen:
    • Führen Sie den folgenden API-Aufruf aus, um das Start- und Enddatum der vom Entwickler erworbenen Preispläne abzurufen:
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
      
    • Führen Sie den folgenden API-Aufruf aus, um die Anzahl der erfolgreichen Transaktionen des Entwicklers zu ermitteln:
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D
      
  2. In der Edge-Benutzeroberfläche können Sie auch die Anzahl der Aufrufe prüfen, die ein Entwickler ausführen darf, indem Sie Folgendes auswählen:

    Pakete > PackageName > RatePlanName > Preisliste

    Wenn der Paketname beispielsweise Pro Package und es sich um einen kostenlosen Tarif handelt, lautet der Pfad:

    Pakete > Pro-Paket > Kostenloser Tarif > Preisliste

NO_CURRENT_PUBLISHABLE_ENTITY

Der Entwickler muss einen Tarifplan erwerben, um API-Aufrufe ausführen zu können.

Probleme bei der Einrichtung der Monetarisierung

Symptome

Probleme bei der Einrichtung der Monetarisierung können verschiedene Symptome haben, z. B.:

  • Die Webhooks-Funktion funktioniert nicht.
  • Webhooks können nicht erstellt werden
  • Webhook-Benachrichtigungen werden nicht ausgelöst
  • Monetarisierungsberichte enthalten keine Transaktionen. So zeigen die Analytics-Daten beispielsweise an, dass der Entwickler viele Transaktionen in einem bestimmten Zeitraum abgeschlossen hat, aber in den Monetarisierungsberichten wird keine dieser Transaktionen aufgeführt.
  • Transaktionen werden nicht erfasst

Fehlermeldungen

Möglicherweise werden keine Fehlermeldungen angezeigt, es werden aber Probleme angezeigt, wie im Abschnitt Symptome beschrieben.

Mögliche Ursachen

Wenn du eines der unter Symptome aufgeführten Symptome siehst, werden die Transaktionen höchstwahrscheinlich nicht monetarisiert.

Ursache ermitteln

  1. Prüfen Sie mit dem im folgenden Abschnitt beschriebenen Verwaltungs-API-Aufruf, ob die Transaktionen monetarisiert werden.

    Status von Transaktionen ansehen

  2. Wenn innerhalb des angegebenen Zeitraums keine Transaktionen als SUCCESS aufgelistet werden, werden sie nicht monetarisiert.

Übliche Gründe dafür, dass Transaktionen nicht monetarisiert werden:

In den folgenden Abschnitten wird beschrieben, wie die einzelnen Probleme diagnostiziert und behoben werden können.

Richtlinie zur Prüfung der Monetarisierungslimits wird nicht im API-Proxy verwendet

Diagnose

  1. Prüfen Sie, ob die Richtlinie zur Überprüfung der Monetarisierungslimits an die API-Proxys angehängt ist.
  2. Wenn die Richtlinie nicht angehängt ist, kann dies der Grund dafür sein, dass Transaktionen als FAILED aufgeführt werden.

Auflösung

Hängen Sie die Richtlinie zur Überprüfung der Monetarisierungslimits an die erforderlichen API-Proxys an, wie unter Monetarisierungslimits für API-Proxys erzwingen beschrieben.

Wenn das Problem weiterhin besteht, prüfen Sie, ob das API-Produkt nicht monetarisiert wird.

API-Produkt wird nicht monetarisiert

Diagnose

  1. Prüfen Sie, ob das API-Produkt monetarisiert ist (nur monetarisierte API-Produkte werden bewertet und unter „Transaktionen“) aufgeführt. Ein monetarisiertes Produkt ist ein Produkt, für das mindestens ein aktiver Preisplan verfügbar ist.
  2. Verwenden Sie den folgenden Verwaltungs-API-Aufruf, um die Liste der monetarisierten API-Produkte abzurufen:
    1. Wenn Sie Nutzer einer öffentlichen Cloud sind, verwenden Sie die folgende API:
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
      
    2. Wenn Sie ein Private Cloud-Nutzer sind, verwenden Sie die folgende API:
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
      
  3. Wenn das mit Ihrem API-Proxy verknüpfte API-Produkt nicht monetarisiert wird, kann dies der Grund dafür sein, dass die Transaktionen nicht monetarisiert werden.

Auflösung

Führen Sie die folgenden Schritte aus, um ein API-Produkt zu monetarisieren:

  1. Konfigurieren Sie die Transaktionsaufzeichnungsrichtlinie.

  2. Prüfen Sie, ob das API-Produkt einen aktiven Tarifplan hat.

Wenn das Problem weiterhin besteht, prüfen Sie, ob die Transaktionsaufzeichnungsrichtlinie falsch definiert ist.

Richtlinie zur Transaktionsaufzeichnung falsch definiert

Diagnose

  1. Aktiviere das UI-Trace für den API-Proxy, an den die Richtlinie zur Überprüfung von Monetarisierungslimits angehängt ist.
  2. Wählen Sie eine bestimmte API-Anfrage aus dem UI-Trace aus.
  3. Wählen Sie den Analytics-Ablauf AX aus und prüfen Sie, ob die folgenden Variablen für den Monetarisierungsablauf die richtigen Werte haben:
    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. Hier ist ein Beispiel-UI-Trace, das zeigt, dass die Mint-Flow-Variablen korrekt eingerichtet sind.

  5. Wenn in der Variablen mint.tx.status ein Fehler auftritt, ist dies ein Hinweis darauf, dass die Richtlinie zur Transaktionsaufzeichnung falsch definiert ist.

Auflösung

  1. Prüfen Sie, ob alle unter Richtlinie zur Transaktionsaufzeichnung erstellen dokumentierten Schritte beim Erstellen der Richtlinie zur Transaktionsaufzeichnung korrekt ausgeführt wurden.
  2. Der Schlüsselwert ist das Erfolgskriterium für Transaktionen, das in der Richtlinie zur Transaktionsaufzeichnung festgelegt ist. Siehe Beispiele für das Festlegen von Erfolgskriterien für Transaktionen in einer Richtlinie zur Transaktionsaufzeichnung

Entwickler hat keinen Tarifplan erworben

Diagnose

  1. Verwenden Sie den folgenden Verwaltungs-API-Aufruf, um die vom Entwickler erworbenen Preispläne zu prüfen:
    1. Wenn Sie Public Cloud-Nutzer sind, verwenden Sie die folgende API:
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
      
    2. Wenn Sie die private Cloud nutzen, verwenden Sie die folgende API:
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
      
  2. Ermitteln Sie anhand der Antwort aus dem obigen Aufruf den Tarif, der aktiv war, als die Transaktion durch den Entwickler abgeschlossen wurde.

Auflösung

Der Entwickler muss den Tarif entsprechend seinen Anforderungen kaufen und dann die Transaktionen/APIs ausführen.

Wenn das Problem weiterhin besteht, wenden Sie sich an den Apigee Edge-Support.