Debugging der Monetarisierung mit dem Debugging-Tool

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Beheben Sie Fehler bei der Monetarisierung wie in den folgenden Abschnitten beschrieben.

Debugging in der Phase der Authentifizierungsrichtlinie

Die Apigee-Monetarisierung verwendet die VerifyAPIKey- oder VerifyAccessToken-Richtlinie, um festzustellen, ob eine eingehende Anfrage monetarisierbar ist. Dazu wird das aktive veröffentlichte Tarifpaket geprüft. Weitere Informationen zum Hinzufügen der Richtlinie finden Sie unter Authentifizierungsrichtlinie hinzufügen.

Die folgende Abbildung zeigt beispielsweise die Details der VerifyAPIKey-Richtlinienphase im Anfrageablauf.

Nach der Authentifizierung des Nutzers prüft die VerifyAPIKey-Richtlinie alle veröffentlichten Tarifpakete, um festzustellen, ob und welche davon aktiv sind, basierend auf den Aktivierungs- und Ablaufzeiten. Wird ein aktives veröffentlichtes Tarifpaket gefunden, werden die folgenden Ablaufvariablen ausgefüllt:

Ablaufvariable	Einstellung
mint.mintng_is_apiproduct_monetized	true, wenn ein aktives veröffentlichtes Tarifpaket gefunden wird.
mint.mintng_rate_plan_id	Tarifpaket-ID.
mint.rateplan_end_time_ms	Ablaufzeit für das Tarifpaket. Beispiel: 1619433556408
mint.rateplan_start_time_ms	Aktivierungszeit des Tarifpakets. Beispiel: 1618433956209

Wird kein aktives veröffentlichtes Tarifpaket gefunden, wird die Ablaufvariable mint.mintng_is_apiproduct_monetized auf false gesetzt und die zusätzlichen Ablaufvariablen werden nicht ausgefüllt.

Weitere Informationen finden Sie unter Mint-Ablaufvariablen.

Debugging in der Phase der Richtlinie "MonetizationLimitsCheck"

Für die Apigee-Monetarisierung wird die Richtlinie "MonetizationLimitsCheck" verwendet, um Entwicklerabos für das API-Produkt zu erzwingen. Weitere Informationen zum Hinzufügen der Richtlinie finden Sie unter Entwicklerabos für API-Produkte erzwingen.

Hinweis: Die Richtlinie "MonetizationLimitsCheck" hat keine Auswirkungen, wenn kein aktives veröffentlichtes Tarifpaket gefunden wird und die Ablaufvariable mint.mintng_is_apiproduct_monetized auf false gesetzt ist.

Die folgende Abbildung zeigt beispielsweise die Details der MonetizationLimitsCheck-Richtlinienphase im Anfrageablauf.

Wenn der Entwickler ein Abo für das API-Produkt erworben hat, werden die folgenden Ablaufvariablen ausgefüllt:

Ablaufvariable	Beschreibung
mint.limitscheck.is_request_blocked	true für blockierte Anfragen.
mint.limitscheck.is_subscription_found	true, wenn ein API-Abo gefunden wird
mint.limitscheck_purchased_product_name	Name des erworbenen API-Produkts. Beispiel: MyProduct
mint.limitscheck.status_message	Statusmeldung. Beispiel: limits_check_success
mint.prepaid_developer_balance	Aktueller Kontostand im Prepaid-Konto-Wallet des Entwicklers, das mit der Währung des Tarifpakets verknüpft ist.
mint.prepaid_developer_currency	Währung des in der Variable mint.prepaid_developer_balance verfügbaren Guthabens.
mint.subscription_end_time_ms	Ende des API-Produktabos
mint.subscription_start_time_ms	Beginn des API-Produktabos Beispiel: 1618433956209

Wenn der Entwickler kein Abo für das API-Produkt erworben hat:

• mint.limitscheck_is_subscription_found-Ablaufvariable ist auf false gesetzt
• mint.limitscheck.is_request_blocked ist auf true gesetzt.
• Es werden keine anderen Ablaufvariablen ausgefüllt.

Weitere Informationen finden Sie unter Mint-Ablaufvariablen.

Debugging in der Phase der Kontingentrichtlinie

Die Apigee-Monetarisierung verwendet die Kontingentrichtlinie, um die auf API-Produktebene definierten Kontingente zu erzwingen. Kontingente definieren die Anzahl der Anfragen, die für ein API-Produkt in einem bestimmten Zeitraum zulässig sind. Weitere Informationen zum Hinzufügen der Richtlinie finden Sie unter Monetarisierungskontingente in einem API-Proxys erzwingen.

Hinweis: Die Richtlinie "MonetizationLimitsCheck" hat keine Auswirkungen, wenn kein aktives veröffentlichtes Tarifpaket gefunden wird und die Ablaufvariable mint.mintng_is_apiproduct_monetized auf false gesetzt ist.

Die folgende Abbildung zeigt beispielsweise die Details der Phase der Kontingentrichtlinie im Anfrageablauf, bei der das Kontingent überschritten wurde.

In diesem Beispiel wurde das Kontingent überschritten. Der HTTP-Status 429 Too Many Requests wird zurückgegeben und die Ablaufvariablen ratelimit.* werden ausgefüllt, um weitere Informationen zur Kontingentausnahme bereitzustellen. Eine Beschreibung von ratelimit.* finden Sie in den Ablaufvariablen der Kontingentrichtlinie.

Fehler in der DataCapture-Richtlinienphase beheben

Apigee verwendet die von der DataCapture-Richtlinie erfassten Monetarisierungsvariablen für die Bewertung, die Berechnung der Umsatzbeteiligung und die Analyse. Weitere Informationen zum Erfassen der Monetarisierungsvariablen in der Richtlinie finden Sie unter Monetarisierungsdaten erfassen.

Die folgende Abbildung zeigt beispielsweise die Details der Ausführungsphase der DataCapture-Richtlinie im Antwortablauf.

Wenn beim Erfassen der Monetarisierungsvariablen keine Fehler auftreten, werden die folgenden Ablaufvariablen für eine Transaktion gefüllt:

Ablaufvariable	Beschreibung
mint.mintng_currency	Währung für die Berechnung des Umsatzes. Diese Ablaufvariable hat den Wert der Monetarisierungsvariable currency.
mint.mintng_price	Umsatz für die Berechnung des Entwickleranteils. Diese Ablaufvariable hat den Wert der Monetarisierungsvariable revShareGrossPrice.
mint.mintng_price_multiplier	Faktor (Multiplikator), mit dem die Kosten pro Transaktion multipliziert werden. Diese Ablaufvariable hat den Wert der Monetarisierungsvariable perUnitPriceMultiplier.
mint.mintng_tx_success	Gibt an, ob die Transaktion monetarisiert wird. Diese Ablaufvariable hat den Wert der Monetarisierungsvariable transactionSuccess.

Debugging in der Phase der monetarisierten API-Proxyausführung

Nach erfolgreicher Ausführung des monetarisierten API-Proxys wird eine Reihe von Ablaufvariablen mit Informationen zu den nutzungsabhängigen Gebühren und angewendeten Preisen der Monetarisierung erstellt.

Die folgende Abbildung zeigt beispielsweise die Details der Phase Proxy-Ausführung im PostClient-Ablauf, wo die Variablen gefüllt werden.

Wenn die monetarisierte API-Proxyausführung erfolgreich ist, werden die folgenden Ablaufvariablen ausgefüllt:

Ablaufvariable	Beschreibung
message.status.code	HTTP-Statuscode der Antwortnachricht vom Ziel. Wenn Ihre Antwort eine Richtlinie enthält, wird der Wert dieser Variable durch den von der Richtlinie zurückgegebenen Statuscode überschrieben.
mint.limitscheck.is_request_blocked	Flag, das angibt, ob die API-Anfrage geblockt wird.
mint.mintng_consumption_pricing_rates	Nutzungsbasierte Gebühren, die im Tarif festgelegt sind.
mint.mintng_consumption_pricing_type	Nutzungsbasierter Preistyp, der im Tarif festgelegt ist. Beispiel: FIXED_PER_UNIT
mint.mintng_dev_share	Mit dem Entwickler zu teilender Umsatz.
mint.mintng_price_multiplier	Faktor (Multiplikator), der von der DataCapture-Richtlinie erfasst wird. Die Kosten pro Transaktion werden mit diesem Faktor multipliziert.
mint.mintng_rate	Gebühr für den API-Aufruf.
mint.mintng_rate_before_multipliers	Preis für den API-Aufruf ohne die perUnitPriceMultiplier-Berechnung.
mint.mintng_revenue_share_rates	Im Tarif festgelegten Umsatzbeteiligungraten.
mint.mintng_revenue_share_type	Umsatzbeteiligungstyp, der im Tarif festgelegt ist.
mint.prepaid_updated_developer_usage	Aktuelle Nutzung des Prepaid-Entwicklers.
mint.status	Der Status des monetarisierten Aufrufs. Wird nur bei einem Fehler gefüllt.
mint.status_code	HTTP-Statuscode des Monetarisierungsaufrufs. Wird nur bei einem Fehler gefüllt.
mint.tx_success_result	Gibt an, ob die Monetarisierung für die Transaktion erfolgreich ist.

Eine detaillierte Beschreibung aller Variablen finden Sie unter Mint-Ablaufvariablen.