BILLING_API Scope des Workspace-API-Schlüssels. Schreibzugriffe laufen als der Service Account, dem der Schlüssel gehört. Diese API lädt niemanden ein und deaktiviert niemanden. Dafür nutzt du die User Management API.
Basis-URL
Voraussetzungen
- API-Schlüssel mit dem Scope
BILLING_API - Der Besitzer ist ein Service Account, der nicht gelöscht ist und eine aktive Admin-Mitgliedschaft hat
USER_MANAGEMENT_APIam selben Schlüssel, wenn duemail,nameoder einen E-Mail-Filter brauchst
Extra-Usage-Budget setzen
PUT /users/{userId}/extra-usage-budget nimmt das Budget direkt entgegen. Es gibt kein Hüllenfeld.
{ "type": "none" } entfernt das Extra-Kontingent. { "type": "unlimited" } entfernt die Zahlenobergrenze. Ein begrenzter Betrag darf null sein.
War das effektive Budget begrenzt und ist das neue effektive Budget höher oder unbegrenzt, wird die offene Nutzungslimit-Anfrage des Mitglieds geschlossen. Dasselbe oder ein niedrigeres Budget lässt die Anfrage offen. Ohne usageRequestId wird das Budget gespeichert, auch wenn das Schließen der Anfrage fehlschlägt.
Übergib usageRequestId in der Query, um genau diese Anfrage im selben Schreibzugriff zu beantworten. Das Budget wird nur gespeichert, wenn die Anfrage zu diesem Mitglied gehört, noch offen ist und das effektive Budget wie oben steigt. Sonst wird nichts geschrieben. Fehlt die Anfrage oder gehört sie nicht zu diesem Mitglied, kommt 404 mit code NOT_FOUND. Ist sie nicht mehr offen, kommt 409 mit code USAGE_REQUEST_NOT_PENDING. Steigt das Kontingent nicht, kommt 409 mit code USAGE_REQUEST_NOT_ANSWERED. Die Anfrage bleibt offen.
Die Antwort ist das Mitgliedsobjekt mit extraUsagePeriodSpend auf null.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.