Zum Hauptinhalt springen
Liste aktive menschliche Mitglieder, ändere einen Plan und setze das Extra-Nutzungslimit. Beträge sind Euro. Die Aufrufe laufen über den 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.
Diese Routen gelten, wenn GET /billing/v1/mode den Modus ai-models-included liefert. Ein Dedicated Deployment liefert immer bring-your-own-keys, auch wenn Langdock die Modellschlüssel verwaltet. Der andere Modus antwortet mit 409 und code BILLING_MODE_MISMATCH.

​
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_API am selben Schlüssel, wenn du email, name oder einen E-Mail-Filter brauchst
Ein Mitgliedsobjekt enthält email und name nur, wenn der Schlüssel auch USER_MANAGEMENT_API hat. Ohne diesen Scope fehlen die Felder. name kann null sein, wenn es enthalten ist.
plan ist business (Business) oder business_max (Business Max). configured ist das am Mitglied gespeicherte Limit: inherit, limited oder unlimited. inherit heißt, das Mitglied hat keine eigene Obergrenze. Ein explizites limited oder unlimited schlägt den Plan und jede Gruppe. effective ist das Limit, das gilt. Bei inherit gilt der höhere Wert aus Plan-Standard und Gruppenlimits. Ein unbegrenzter Wert schlägt einen begrenzten. Bei gleichem Betrag schlägt die Gruppe den Plan. Setzen zwei Gruppen denselben Betrag, ist die Quelle die Gruppe, deren Name zuerst kommt. source.type ist plan, group, user oder workspace. Eine group-Quelle enthält zusätzlich groupId und groupName. source ist user, wenn das Mitglied eine eigene Obergrenze hat. Eine unbegrenzte Gruppe hebt diese Obergrenze nicht auf. source ist workspace und der effektive Betrag ist null, wenn die Extra-Nutzung für den Workspace aus ist. Ein unbegrenztes Limit eines Mitglieds oder einer Gruppe hebt diesen Schalter und das Extra-Nutzungslimit des Workspace nicht auf. extraUsagePeriodSpend ist die Extra-Nutzung im aktuellen Zeitraum. Der Wert ist null, wenn der Workspace die Ausgaben pro Nutzer ausblendet. Ein Nutzer, der kein aktives menschliches Mitglied ist, gibt 404 zurück.
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.