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

​
Extra-Nutzungslimit setzen

PUT /users/{userId}/extra-usage-limit nimmt das Limit direkt entgegen. Es gibt kein Hüllenfeld.
{ "type": "inherit" } stellt die Vorgaben von Plan und Gruppe wieder her. { "type": "unlimited" } entfernt die persönliche Obergrenze. Ein begrenzter Betrag darf null sein. Dieser Wert akzeptiert kein none. Ein explizites Limit schlägt den Plan und jede Gruppe. Bei inherit gilt das höhere Limit aus Plan und Gruppe. Unter Extra-Nutzung: Nutzer abrufen steht, wie effective.source gewählt wird. Ist die Extra-Nutzung aus, oder greift das Extra-Nutzungslimit des Workspace, gilt das auch über einem unbegrenzten persönlichen Limit. War das effektive Limit begrenzt und ist das neue effektive Limit höher oder unbegrenzt, wird die offene Nutzungslimit-Anfrage des Mitglieds geschlossen. Dasselbe oder ein niedrigeres Limit lässt die Anfrage offen. Ohne usageRequestId wird das Limit 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 Limit wird nur gespeichert, wenn die Anfrage zu diesem Mitglied gehört, noch offen ist und das effektive Limit 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.