Zum Hauptinhalt springen
GET
List usage requests
Liste Nutzungslimit-Anfragen von Mitgliedern, lies eine Anfrage und lehne eine Anfrage ab, die noch offen ist. Es gibt keinen Webhook. Frage die Liste regelmäßig ab. Um eine Anfrage zu genehmigen, erhöhst du den Plan oder das Extra-Usage-Budget dieses Mitglieds und übergibst usageRequestId an diesem Schreibzugriff. Siehe Billing-Nutzer. 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.

Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

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
status ist pending, resolved oder dismissed. Ohne Filter listest du jeden Status. Die Ergebnisse kommen mit den ältesten 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 zurück. Eine Anfrage, die zwischen zwei Seiten beantwortet wird, lässt spätere Zeilen nicht aus. Die Listenantwort ist { "usageRequests": [ ... ] } und enthält nextCursor bis zur letzten Seite. Eine einzelne Anfrage kommt als Objekt zurück. Eine Anfrage außerhalb dieses Workspace gibt 404 mit code NOT_FOUND zurück. 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 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.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Abfrageparameter

status
enum<string>

Only return requests with this status.

Verfügbare Optionen:
pending,
resolved,
dismissed
limit
integer
Standard:50
Erforderlicher Bereich: 1 <= x <= 250
cursor
string<uuid>

Use nextCursor from the preceding page.

Antwort

Successful response.

usageRequests
object[]
erforderlich
nextCursor
string<uuid>