Zum Hauptinhalt springen
GET
Read a usage request
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
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.
email und name sind nur dabei, wenn der Schlüssel auch USER_MANAGEMENT_API hat. Ohne den Scope fehlen die Felder. name kann null sein, wenn es enthalten ist. resolution ist increased_limit, upgraded_plan, dismissed oder null, solange die Anfrage offen ist. resolvedAt und resolvedByUserId sind null, solange sie offen ist. resolvedByUserId ist der Admin oder Service Account, der die Anfrage beantwortet hat.
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"

Pfadparameter

requestId
string<uuid>
erforderlich

Antwort

Successful response.

id
string<uuid>
erforderlich
userId
string<uuid>
erforderlich
status
enum<string>
erforderlich
Verfügbare Optionen:
pending,
resolved,
dismissed
createdAt
string<date-time>
erforderlich
resolvedAt
string<date-time> | null
erforderlich
resolution
enum<string> | null
erforderlich

How the request was answered; null while pending.

Verfügbare Optionen:
increased_limit,
upgraded_plan,
dismissed,
null
resolvedByUserId
string<uuid> | null
erforderlich

Admin or service account that answered the request.

email
string<email>

Present only when the key also has the USER_MANAGEMENT_API scope.

name
string | null

Present only when the key also has the USER_MANAGEMENT_API scope.