Fehlerbehebung bei Problemen mit der Monetarisierung

Sie lesen gerade die Apigee Edge -Dokumentation.
Zur Apigee X -Dokumentation.
info

In diesem Thema finden Sie Informationen und Anleitungen zur Fehlerbehebung bei häufig auftretenden Problemen mit der Monetarisierung.

Entwickler gesperrt

Symptom

Der Entwickler ist gesperrt und kann keine weiteren Monetarisierung Transaktionen oder API-Aufrufe ausführen.

Fehlermeldungen

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

Diagnose

So ermitteln Sie den Grund für die Sperrung des Entwicklers:

  1. Führen Sie den folgenden API-Aufruf aus, um den Fehlercode zu ermitteln, der mit dem gesperrten Entwickler verknüpft ist:
    1. Wenn Sie ein Public Cloud-Nutzer 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 Guthaben des Prepaid-Entwicklerkontos nicht für weitere Transaktionen ausreicht, wird der Entwickler gesperrt.

Bei Entwicklern mit nachträglicher Zahlung kann dieser Fehler auftreten, wenn sie ihr Kreditlimit überschreiten oder wenn das für die verwendete Währung festgelegte Kreditlimit aufgebraucht ist.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

Entwickler kann keine weiteren Transaktionen ausführen

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

NO_CURRENT_PUBLISHABLE_ENTITY

Entwickler hat keinen Tarif erworben

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

Auflösung

Fehler

Schritte zur Fehlerbehebung

INSUFFICIENT_FUNDS

Der Entwickler muss darauf achten, dass das Kontoguthaben oder der verfügbare Kredit ausreicht, um weitere Transaktionen auszuführen.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

  1. Führen Sie die folgenden API-Aufrufe aus, um den Tarif und die Transaktionsdetails des Entwicklers abzurufen:
    • Führen Sie den folgenden API-Aufruf aus, um das Start- und Enddatum von den Tarifen abzurufen, die der Entwickler erworben hat:
      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 abzurufen, die der Entwickler ausgeführt hat:
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D
      
  2. In der Edge-UI können Sie auch die Anzahl der Aufrufe prüfen, die ein Entwickler ausführen darf. Wählen Sie dazu Folgendes aus:

    Pakete > Paketname > Tarifname > Preisliste

    Wenn der Paketname beispielsweise Pro-Paket ist 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 Tarif erwerben, um API-Aufrufe ausführen zu können.

Probleme bei der Einrichtung der Monetarisierung

Symptome

Probleme bei der Einrichtung der Monetarisierung können sich in verschiedenen Symptomen äußern, z. B.:

  • Webhooks funktionieren nicht
  • Webhooks können nicht erstellt werden
  • Webhook-Benachrichtigungen werden nicht ausgelöst
  • In Monetarisierungsberichten werden keine Transaktionen angezeigt. Beispielsweise zeigen die Analytics-Daten, dass der Entwickler in einem bestimmten Zeitraum viele Transaktionen ausgeführt hat, in den Monetarisierungsberichten werden diese Transaktionen jedoch nicht aufgeführt.
  • Transaktionen werden nicht erfasst

Fehlermeldungen

Möglicherweise werden keine Fehlermeldungen angezeigt, aber es treten Probleme auf, wie in dem Abschnitt Symptome beschrieben.

Mögliche Ursachen

Wenn eines der im Abschnitt Symptome aufgeführten Symptome auftritt, werden die Transaktionen sehr wahrscheinlich nicht monetarisiert.

Ursache diagnostizieren

  1. Verwenden Sie den im folgenden Abschnitt beschriebenen API-Aufruf der Verwaltungs-API, um zu prüfen, ob die Transaktionen monetarisiert werden.

    Status von Transaktionen ansehen

  2. Wenn innerhalb des angegebenen Zeitraums keine Transaktionen als ERFOLGREICH aufgeführt werden, werden die Transaktionen nicht monetarisiert.

Die typischen Ursachen dafür, dass Transaktionen nicht monetarisiert werden, sind:

In den folgenden Abschnitten wird beschrieben, wie Sie die einzelnen Probleme diagnostizieren und beheben.

Richtlinie „Monetarisierungslimits prüfen“ wird nicht im API-Proxy verwendet

Diagnose

  1. Prüfen Sie, ob die Richtlinie „Monetarisierungslimits prüfen“ 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 FEHLGESCHLAGEN aufgeführt werden.

Auflösung

Hängen Sie die Richtlinie „Monetarisierungslimits prüfen“ 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 ist.

API-Produkt ist 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 hat mindestens einen aktiven Tarif zur Verfügung.
  2. Verwenden Sie den folgenden API-Aufruf der Verwaltungs-API, um die Liste der monetarisierten API-Produkte abzurufen:
    1. Wenn Sie ein Public Cloud-Nutzer 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 ist, kann dies der Grund dafür sein, dass die Transaktionen nicht monetarisiert werden.

Auflösung

So monetarisieren Sie ein API-Produkt:

  1. Richtlinie zur Transaktionsaufzeichnung konfigurieren.

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

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

Richtlinie zur Transaktionsaufzeichnung ist falsch definiert

Diagnose

  1. Aktivieren Sie das UI-Trace für den API-Proxy, an den die Richtlinie „Monetarisierungslimits prüfen“ angehängt ist.
  2. Wählen Sie im UI-Trace eine bestimmte API-Anfrage aus.
  3. Wählen Sie den Analytics-AX-Ablauf aus und prüfen Sie, ob die folgenden Monetarisierungs-Ablaufvariablen (Mint) 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 sehen Sie ein Beispiel für ein UI-Trace, in dem die Mint-Ablaufvariablen korrekt eingerichtet sind.

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

Auflösung

  1. Achten Sie darauf, dass alle in Richtlinie zur Transaktionsaufzeichnung erstellen beschriebenen Schritte korrekt ausgeführt wurden.
  2. Der Schlüsselwert ist das in der Richtlinie zur Transaktionsaufzeichnung festgelegte Kriterium für den Transaktionserfolg. Siehe Beispiele für das Festlegen von Kriterien für den Transaktionserfolg in einer Richtlinie zur Transaktionsaufzeichnung

Entwickler hat keinen Tarif erworben

Diagnose

  1. Verwenden Sie den folgenden API-Aufruf der Verwaltungs-API, um die vom Entwickler erworbenen Tarife zu prüfen:
    1. Wenn Sie ein 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 ein Private Cloud-Nutzer sind, 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. Suchen Sie in der Antwort des obigen Aufrufs den Tarif, der aktiv war, als die Transaktion vom Entwickler abgeschlossen wurde.

Auflösung

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

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