Zum Hauptinhalt springen
Liste Anfragen von Mitgliedern nach mehr Nutzung, lies eine Anfrage und lehne eine Anfrage ab, die noch offen ist. Es gibt keinen Webhook. Frage die Liste ab. Um eine Anfrage zu genehmigen, hebe den Plan des Mitglieds auf Business Max oder erhöhe das Extra-Nutzungslimit und übergib usageRequestId an diesem Schreibzugriff. Siehe Extra-Nutzung: Plan setzen und Extra-Nutzungslimit setzen. Die Aufrufe laufen über den BILLING_API Scope des Workspace-API-Schlüssels. Die Ablehnung läuft als der Service Account, dem der Schlüssel gehört.
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 oder name brauchst
Mitglieder können nur anfragen, wenn usageRequestsEnabled an ist. status ist pending, resolved oder dismissed. Lass ihn weg, um jeden Status zu listen. Die Ergebnisse kommen älteste zuerst. limit ist standardmäßig 50 und höchstens 250. Gib cursor aus nextCursor zurück. Ein Cursor aus einem anderen Workspace gibt 400 mit code INVALID_CURSOR. Eine Anfrage, die zwischen zwei Seiten beantwortet wird, überspringt spätere Zeilen nicht. Die Listenantwort ist { "usageRequests": [ ... ] } und enthält nextCursor bis zur letzten Seite. Eine einzelne Anfrage zu lesen liefert das Anfrageobjekt. Eine Anfrage außerhalb dieses Workspace gibt 404 mit code NOT_FOUND. Ausgeblendete Ausgaben pro Nutzer blenden diese Anfragen nicht aus. Ein Mitglied, das ein Limit erreicht und nicht anfragt, steht nicht in dieser Liste. Zum Abfragen rufst du GET /usage-requests?status=pending auf und überspringst die Anfragen, die du schon bearbeitet hast.
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.