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:
- Führen Sie den folgenden API-Aufruf aus, um den Fehlercode für den gesperrten Entwickler zu ermitteln:
- 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
- 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
- Wenn Sie Nutzer einer öffentlichen Cloud sind, verwenden Sie die folgende API:
- 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 |
|
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
-
Prüfen Sie mit dem im folgenden Abschnitt beschriebenen Verwaltungs-API-Aufruf, ob die Transaktionen monetarisiert werden.
- 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:
- Richtlinie zu Monetarisierungslimits nicht an API-Proxy angehängt
- APIProduct wird nicht monetarisiert
- Richtlinie zur Transaktionsaufzeichnung falsch definiert
- Der Entwickler hat keinen Preisplan erworben
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
- Prüfen Sie, ob die Richtlinie zur Überprüfung der Monetarisierungslimits an die API-Proxys angehängt ist.
- 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
- 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.
- Verwenden Sie den folgenden Verwaltungs-API-Aufruf, um die Liste der monetarisierten API-Produkte abzurufen:
- 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
- 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
- Wenn Sie Nutzer einer öffentlichen Cloud sind, verwenden Sie die folgende API:
- 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:
- Konfigurieren Sie die Transaktionsaufzeichnungsrichtlinie.
- 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
- Aktiviere das UI-Trace für den API-Proxy, an den die Richtlinie zur Überprüfung von Monetarisierungslimits angehängt ist.
- Wählen Sie eine bestimmte API-Anfrage aus dem UI-Trace aus.
- 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.
Hier ist ein Beispiel-UI-Trace, das zeigt, dass die Mint-Flow-Variablen korrekt eingerichtet sind.
- 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
- Prüfen Sie, ob alle unter Richtlinie zur Transaktionsaufzeichnung erstellen dokumentierten Schritte beim Erstellen der Richtlinie zur Transaktionsaufzeichnung korrekt ausgeführt wurden.
- 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
- Verwenden Sie den folgenden Verwaltungs-API-Aufruf, um die vom Entwickler erworbenen Preispläne zu prüfen:
- 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
- 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
- Wenn Sie Public Cloud-Nutzer sind, verwenden Sie die folgende API:
- 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.