Skip to main content
POST
Nutzung konfigurieren

Übersicht

Legen Sie benutzerbezogene Limits für die Nutzung von Add-on-Guthaben in Ihrer Organisation fest oder heben Sie sie auf. Limits werden immer pro Benutzer angewendet. Wenn Sie den Geltungsbereich auf ein Team oder eine Gruppe festlegen, wird das Limit für jeden einzelnen Benutzer innerhalb dieses Teams oder dieser Gruppe individuell angewendet – es legt kein gemeinsames Limit für das gesamte Team oder die gesamte Gruppe fest.

Anfrage

string
erforderlich
Ihr Service Key mit „Billing Write“-Berechtigungen

Konfiguration des Kreditlimits (eine Option auswählen)

boolean
Auf true setzen, um das bestehende Add-on-Kreditlimit zu zurückzusetzen
integer
Neues Add-on-Kreditlimit festlegen (Ganzzahl)
Sie müssen entweder clear_add_on_credit_cap oder set_add_on_credit_cap angeben, aber nicht beides.

Bereichskonfiguration (eine Option auswählen)

boolean
Auf true setzen, um die benutzerspezifische Obergrenze für alle Benutzer im Team anzuwenden
string
Die benutzerspezifische Obergrenze auf alle Benutzer in einer bestimmten Gruppe anwenden, indem die Gruppen-ID angegeben wird
string
Die Konfiguration auf einen bestimmten Benutzer anwenden, indem dessen E-Mail-Adresse angegeben wird
Es muss eines von team_level, group_id oder user_email angegeben werden, um den Geltungsbereich festzulegen.

Beispielanfrage – Kreditlimit pro Nutzer für alle Teammitglieder festlegen

Beispielanfrage – Kreditobergrenze pro Benutzer für alle Benutzer in einer Gruppe festlegen

Beispielanfrage – Kreditlimit für einen Benutzer festlegen

Beispielanfrage – Guthabenlimit aufheben

Antwort

Der Antworttext ist leer. Ein 200-Statuscode zeigt an, dass der Vorgang erfolgreich war.

Fehlerantworten

Häufige Fehlerfälle:
  • Ungültiger Service Key oder unzureichende Berechtigungen
  • Sowohl clear_add_on_credit_cap als auch set_add_on_credit_cap übergeben
  • Weder clear_add_on_credit_cap noch set_add_on_credit_cap übergeben
  • Mehrere Scope-Parameter übergeben
  • Kein Scope-Parameter übergeben
  • Ungültige Gruppen-ID oder Benutzer-E-Mail-Adresse
  • Rate Limit überschritten