Skip to main content
POST
Nutzerseitenanalysen abrufen

Überblick

Rufen Sie Statistiken zur Nutzeraktivität ab, die auf der Teams-Seite angezeigt werden, darunter Nutzernamen, E-Mail-Adressen, Zeitpunkte der letzten Aktivität, aktive Tage und verwendete Prompt-Credits.

Anfrage

string
erforderlich
Ihr Service-Schlüssel mit den Berechtigungen „Teams Read-only“
string
Ergebnisse nach Nutzern in einer bestimmten Gruppe filtern (optional)
string
Startzeitpunkt im RFC-3339-Format (z. B. 2023-01-01T00:00:00Z). Legt den Beginn des Zeitraums fest, auf dem activeDays und promptCreditsUsed basieren. Falls nicht angegeben, wird standardmäßig der Zeitpunkt vor 1 Jahr verwendet.
string
Endzeitpunkt im RFC-3339-Format (z. B. 2023-12-31T23:59:59Z). Legt das Ende des Zeitraums fest, auf dem activeDays und promptCreditsUsed basieren. Falls nicht angegeben, wird standardmäßig die aktuelle Zeit verwendet.

Beispielanfrage

Antwort

Bei Nicht-Devin-Teams enthält apiKey einen unverschlüsselten API-Schlüssel des Nutzers, keinen Hash. Behandeln Sie ihn als Secret: Entfernen oder schwärzen Sie ihn, bevor Sie Analytics protokollieren, exportieren oder teilen. Falls Sie ungeschwärzte Antworten aufbewahren müssen, beschränken Sie den Zugriff und speichern Sie sie sicher.
array
Array aus Objekten mit Nutzerstatistiken
string
Der Beginn des aktuellen Abrechnungszeitraums des Teams im RFC-3339-Format. Dieses Feld ist unabhängig vom angefragten Zeitraum und begrenzt die Werte von promptCreditsUsed in userTableStats nicht.
string
Das Ende des aktuellen Abrechnungszeitraums des Teams im RFC-3339-Format. Dieses Feld ist unabhängig vom angefragten Zeitraum und begrenzt die Werte von promptCreditsUsed in userTableStats nicht.

Beispielantwort

Die folgenden apiKey-Werte sind Beispielplatzhalter und keine echten Anmeldedaten.

Fehlerantworten

string
Fehlermeldung, die beschreibt, was schiefgelaufen ist
Häufige Fehlerszenarien:
  • Ungültiger Service-Schlüssel oder unzureichende Berechtigungen
  • Ungültiges Zeitstempelformat
  • Gruppe nicht gefunden
  • Rate-Limit überschritten