Zum Hauptinhalt springen
GET
Analysen zu aktiven Benutzern abrufen
Dies ist ein v2-Endpunkt, der Bearer-Token-Authentifizierung und Query-Parameter verwendet, im Gegensatz zur v1 Analytics-API, die Service-Schlüssel im Request-Body verwendet. Siehe unten Authentifizierung.
Dieser Endpunkt ist nicht für die Überwachung der Nutzung in Echtzeit gedacht. Die Daten werden stündlich aggregiert und das Ratenlimit ist niedrig (10 Anfragen pro Stunde pro Team). Verwenden Sie ihn für regelmäßige Berichte und Massenexporte.

Authentifizierung

Dieser Endpunkt verwendet die Bearer-Token-Authentifizierung. Geben Sie Ihr Token im Authorization-Header an:
Verwenden Sie entweder einen Devin-Service-Benutzer-API-Schlüssel mit der Berechtigung Use Local Analytics API oder einen Windsurf- Service-Schlüssel mit der Berechtigung Analytics Read. Informationen zum Erstellen beider Schlüssel finden Sie unter Authentifizierung.

Was als aktiver Nutzer gilt

Ein Nutzer wird für ein bestimmtes Zeitintervall als aktiv gezählt, wenn darin ein Abrechnungsereignis auftritt. Das active_users-Feld gibt die Anzahl der eindeutigen Nutzer an.
Die Anzahl aktiver Nutzer umfasst die Nutzung aus sowohl der Devin CLI als auch Devin Desktop. Ein Nutzer, der in einem der beiden (oder in beiden) aktiv ist, wird gezählt, und pro Zeitintervall nur einmal.

Gruppierung und Granularität

Verwenden Sie granularity und group_by, um die Struktur der zurückgegebenen Daten zu steuern:
  • Keine Granularität oder Gruppierung — gibt eine einzelne Zeile mit der Gesamtzahl aktiver Nutzer für den gesamten Datumsbereich zurück
  • granularity=daily — jede Zeile enthält einen timestamp im Format YYYY-MM-DD (täglich aktive Nutzer)
  • granularity=monthly — jede Zeile enthält einen timestamp im Format YYYY-MM (monatlich aktive Nutzer)
  • group_by=user — gibt eine Zeile pro aktivem Nutzer mit einer user_id zurück; active_users ist in jeder Zeile 1
Im Gegensatz zu Verbrauch abrufen unterstützt der Endpunkt für aktive Nutzer bei group_by nur user. Andere Dimensionen (model_uid, ide, os) sind hier nicht gültig.

Paginierung

Die Ergebnisse sind paginiert, mit einer Standardseitengröße von 1.000 Zeilen (max. 10.000). Wenn weitere Ergebnisse verfügbar sind, enthält die Antwort im Objekt pagination einen next_page_cursor. Übergeben Sie ihn als query-Parameter page_cursor, um die nächste Seite abzurufen. Seiten-Cursor laufen nach 24 Stunden ab. Eine nachfolgende Seitenanfrage zählt nicht als neue Abfrage für Ihr Ratenlimit.

Ratenlimits

Für diesen Endpunkt gilt ein Limit von 10 Anfragen pro Stunde pro Team. Wenn Sie dieses Limit überschreiten, gibt der Server 429 Too Many Requests mit einem Retry-After-Header zurück. Die Paginierung einer früheren Abfrage (durch Folgen eines next_page_cursor) wird nicht auf dieses Limit angerechnet — nur die erste Abfrage für jeden Bericht. Das niedrige Limit spiegelt wider, dass dieser Endpunkt für regelmäßige Berichterstattung gedacht ist, nicht für die Nutzungsüberwachung in Echtzeit.

Autorisierungen

Authorization
string
header
erforderlich

Ein Service-Schlüssel mit der Berechtigung Analytics Read, übergeben als Bearer-Token im Header Authorization.

Erstellen Sie einen Service-Schlüssel in Ihren Team Settings im Abschnitt „Service Keys“.

Abfrageparameter

start_date
string<date>
erforderlich

Beginn des Zeitraums (einschließlich) im Format YYYY-MM-DD.

end_date
string<date>
erforderlich

Ende des Zeitraums (einschließlich) im Format YYYY-MM-DD. Der Zeitraum darf höchstens 90 Tage umfassen.

product
enum<string>
erforderlich

Produkt, für das aktive Benutzer abgefragt werden sollen.

Verfügbare Optionen:
agent
granularity
enum<string>

Zeitliche Granularität für die Gruppierung der Ergebnisse. Ist sie angegeben, enthält jede Zeile ein timestamp-Feld. Andernfalls wird die Anzahl aktiver Benutzer über den gesamten Zeitraum aggregiert.

Verfügbare Optionen:
daily,
monthly
group_by
enum<string>

Dimension, nach der die Ergebnisse gruppiert werden sollen. Der Endpunkt für aktive Benutzer unterstützt nur user und gibt damit eine Zeile pro aktivem Benutzer zurück (jeweils mit active_users = 1).

Verfügbare Optionen:
user
models
string

Kommagetrennte Liste von Modell-UIDs, auf die die Ergebnisse beschränkt werden sollen.

group_id
string

Ergebnisse auf Nutzer einer spezifischen Gruppe beschränken. Der Service-Schlüssel muss Zugriff auf diese Gruppe haben.

user_id
string

Ergebnisse auf einen spezifischen Nutzer (Authentifizierungs-UID) beschränken.

page_size
integer
Standard:1000

Maximale Anzahl der Zeilen, die pro Seite zurückgegeben werden.

Erforderlicher Bereich: 1 <= x <= 10000
page_cursor
string

Opaker Cursor aus dem Feld pagination.next_page_cursor einer vorherigen Antwort, mit dem die nächste Seite abgerufen wird.

Antwort

Daten zu aktiven Benutzern erfolgreich zurückgegeben.

data
object[]
erforderlich

Array von Datenzeilen zu aktiven Nutzern.

pagination
object
erforderlich
metadata
object
erforderlich