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
Plan ändern
PUT /users/{userId}/plan nimmt den Plan direkt entgegen.
standard. Den Plan zu setzen, den das Mitglied schon hat, ändert den Plan nicht. Der Wechsel auf power_user schließt die offene Nutzungsanfrage, die an diesem Upgrade hängt. Der Wechsel auf standard nicht. Eine Anfrage, die nach dem Upgrade entsteht, bleibt offen. power_user noch einmal zu setzen versucht eine verknüpfte Anfrage erneut zu schließen, die beim ersten Mal offen blieb, schließt diese neuere Anfrage aber nicht. Ohne usageRequestId wird der Planwechsel gespeichert, auch wenn das Schließen der Anfrage fehlschlägt.
Übergib usageRequestId in der Query, um genau diese Anfrage im selben Schreibzugriff zu beantworten. Der Plan wird nur gespeichert, wenn die Anfrage zu diesem Mitglied gehört, noch offen ist und der Wechsel von standard auf power_user geht. 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. Der aktuelle Status steht in details.status. 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.