Monetarisierungslimits für API-Proxys erzwingen

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen.
info

Hängen Sie die Richtlinie „Monetization Limits Check“ an API-Proxys an, um Monetarisierungslimits zu erzwingen. Die Richtlinie wird unter den folgenden Bedingungen ausgelöst:

  • Der Entwickler, der auf die monetarisierte API zugreift, ist nicht registriert oder hat den Tarif nicht abonniert.
  • Der Entwickler hat das Transaktionsvolumen für den abonnierten Tarif überschritten.
  • Das Guthaben des Prepaid-Kontos des Entwicklers oder das Kreditlimit des Postpaid-Kontos wurde erreicht.

Die Richtlinie „Monetization Limits Check“ ist so konzipiert, dass sie in den oben aufgeführten Situationen einen Fehler auslöst und einen API-Aufruf blockiert. Die Richtlinie erweitert die RaiseFault-Richtlinie (siehe RaiseFault-Richtlinie). Sie können die zurückgegebene Nachricht anpassen. Die anwendbaren Bedingungen werden aus Geschäftsvariablen abgeleitet.

Richtlinie „Monetization Limits Check“ über die Benutzeroberfläche anhängen

Um Monetarisierungslimits zu erzwingen, muss eine Richtlinie zur Überprüfung von Monetarisierungslimits an den Anforderungsablauf in API-Proxys angehängt werden, die auf Ihre APIs zugreifen. Die Richtlinie „Monetization Limits Check“ sollte nach einer beliebigen Richtlinie „VerifyAPIKey“ oder „AccessTokenValidation“ in der Anfrage angehängt werden.

Sie können eine Richtlinie vom Typ „MonetizationLimitsCheck“ beim Erstellen eines API-Proxys oder nach der Erstellung eines API-Proxys anhängen.

Wenn Sie einen API-Proxy erstellen, wie unter Einen einfachen API-Proxy erstellen beschrieben, wird der Konfigurationsbereich „Monetarisierung“ im Assistenten angezeigt, sofern die Monetarisierung installiert ist.

Edge

Wählen Sie auf der Seite Allgemeine Richtlinien des Assistenten das Kästchen Monetarisierungslimits erzwingen aus, um eine Richtlinie vom Typ „Monetization Limits Check“ anzuhängen.

Richtlinie „Monetarisierungsgrenzen prüfen“

Auf der Seite „Zusammenfassung“ des Assistenten werden die Richtlinien zusammengefasst. Prüfen Sie, ob die Monetarisierungsrichtlinie aufgeführt ist. Dies weist darauf hin, dass die Richtlinie „Monetization Limits Check“ an den API-Proxy angehängt wird, wie unten beschrieben.

Neue Edge-UI (Private Cloud)

  1. Melden Sie sich in der New Edge-Benutzeroberfläche unter http://host:3001/edge an. Dabei ist host die IP-Adresse oder der DNS-Name des Hosts, auf dem die New Edge-Benutzeroberfläche ausgeführt wird.
  2. Wählen Sie in der linken Navigationsleiste Develop > API Proxies aus und klicken Sie auf +Proxy, um den Assistenten zum Erstellen von Proxys zu öffnen.
  3. Wählen Sie auf der Seite Allgemeine Richtlinien des Assistenten das Kästchen Monetarisierungslimits erzwingen aus, um eine Richtlinie vom Typ „MonetizationLimitsCheck“ anzuhängen.

    Richtlinie „Monetarisierungsgrenzen prüfen“

  4. Prüfen Sie auf der Seite Zusammenfassung des Assistenten, ob die Monetarisierungsrichtlinie aufgeführt ist. Dies weist darauf hin, dass die Richtlinie „MonetizationLimitsCheck“ an den API-Proxy angehängt wird.

Die Richtlinie „Monetization Limits Check“ wird dem Anfrage-PreFlow des ProxyEndpoint nach der Richtlinie „VerifyAPIKey“ oder „AccessTokenValidation“ hinzugefügt, wie in der folgenden Abbildung dargestellt.

So fügen Sie die Richtlinie „Monetarisierungslimits prüfen“ einem bereits erstellten API-Proxy hinzu:

  1. Klicken Sie im API-Proxy-Editor für den Standard-Proxy-Endpunkt auf PreFlow.
  2. Klicken Sie im Anfrageablauf auf +Schritt.
  3. Wählen Sie in der Kategorie „Vermittlung“ die Option „Prüfung der Monetarisierungslimits“ aus.

  4. Ändern Sie die Felder im Dialogfeld „Schritt hinzufügen“ nach Bedarf und klicken Sie auf Hinzufügen.

Die Richtlinie wird nach einer VerifyAPIKey- oder AccessTokenValidation-Richtlinie an den Anfrageablauf angehängt und auf Anfragenachrichten von Client-Apps an den ProxyEndpoint-PreFlow angewendet.

Weitere Informationen zum Konfigurieren der XML-Datei für die MonetizationLimitsCheck-Richtlinie finden Sie unter MonetizationLimitsCheck-Richtlinie.