Salt la conținutul principal
POST
/
api
/
v1
/
UserPageAnalytics
Obține Analytics pentru pagina utilizatorului
curl --request POST \
  --url https://server.codeium.com/api/v1/UserPageAnalytics \
  --header 'Content-Type: application/json' \
  --data '
{
  "service_key": "<string>",
  "group_name": "<string>",
  "start_timestamp": "<string>",
  "end_timestamp": "<string>"
}
'
{
  "userTableStats": [
    {
      "name": "<string>",
      "email": "<string>",
      "lastUpdateTime": "<string>",
      "apiKey": "<string>",
      "activeDays": 123,
      "disableCodeium": true,
      "role": "<string>",
      "signupTime": "<string>",
      "lastAutocompleteUsageTime": "<string>",
      "lastChatUsageTime": "<string>",
      "lastCommandUsageTime": "<string>",
      "promptCreditsUsed": 123,
      "teamStatus": "<string>"
    }
  ],
  "billingCycleStart": "<string>",
  "billingCycleEnd": "<string>",
  "error": "<string>"
}

Prezentare generală

Obține statistici despre activitatea utilizatorilor care apar pe pagina Teams, inclusiv numele utilizatorilor, emails, ultimele momente de activitate, zilele active și creditele de prompt utilizate.

Cerere

service_key
string
obligatoriu
Cheia ta de serviciu cu permisiuni „Teams Read‑only”
group_name
string
Filtrează rezultatele la utilizatorii dintr-un grup anume (opțional)
start_timestamp
string
Ora de început în format RFC 3339 (de ex., 2023-01-01T00:00:00Z). Influențează doar calculul activeDays. Dacă nu este furnizat, valoarea implicită este cu 1 an în urmă.
end_timestamp
string
Ora de sfârșit în format RFC 3339 (de ex., 2023-12-31T23:59:59Z). Influențează doar calculul activeDays. Dacă nu este furnizat, valoarea implicită este ora curentă.

Exemplu de solicitare

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_name": "engineering_team",
  "start_timestamp": "2024-01-01T00:00:00Z",
  "end_timestamp": "2024-12-31T23:59:59Z"
}' \
https://server.codeium.com/api/v1/UserPageAnalytics

Răspuns

userTableStats
array
Array de obiecte cu statistici despre utilizatori
billingCycleStart
string
Începutul ciclului de facturare curent, în format RFC 3339. Valorile promptCreditsUsed din userTableStats corespund utilizării din acest ciclu de facturare.
billingCycleEnd
string
Sfârșitul ciclului de facturare curent, în format RFC 3339. Valorile promptCreditsUsed din userTableStats corespund utilizării din acest ciclu de facturare.

Exemplu de răspuns

{
  "userTableStats": [
    {
      "name": "Alice",
      "email": "alice@windsurf.com",
      "lastUpdateTime": "2024-10-10T22:56:10.771591Z",
      "apiKey": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "activeDays": 178,
      "role": "admin",
      "signupTime": "2024-01-15T08:30:00Z",
      "lastAutocompleteUsageTime": "2024-10-10T22:56:10Z",
      "lastChatUsageTime": "2024-10-10T20:30:00Z",
      "promptCreditsUsed": 12500,
      "teamStatus": "USER_TEAM_STATUS_APPROVED"
    },
    {
      "name": "Bob",
      "email": "bob@windsurf.com",
      "lastUpdateTime": "2024-10-10T18:11:23.980237Z",
      "apiKey": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
      "activeDays": 210,
      "role": "member",
      "signupTime": "2024-02-01T10:00:00Z",
      "lastAutocompleteUsageTime": "2024-10-10T18:11:23Z",
      "lastChatUsageTime": "2024-10-09T14:22:00Z",
      "lastCommandUsageTime": "2024-10-08T09:15:00Z",
      "promptCreditsUsed": 8300,
      "teamStatus": "USER_TEAM_STATUS_APPROVED"
    }
  ],
  "billingCycleStart": "2024-10-01T00:00:00Z",
  "billingCycleEnd": "2024-11-01T00:00:00Z"
}

Răspunsuri de eroare

error
string
Mesaj de eroare care descrie problema apărută
Scenarii de eroare frecvente:
  • Cheie de serviciu invalidă sau permisiuni insuficiente
  • Format de timestamp invalid
  • Grupul nu a fost găsit
  • Limită de rată depășită