> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obține Analytics pentru pagina utilizatorului

> Preia date despre activitatea utilizatorilor, inclusiv nume, emails, momentele ultimei activități, zilele active și credite de prompt utilizate, din pagina Teams.

<div id="overview">
  ## Prezentare generală
</div>

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.

<div id="request">
  ## Cerere
</div>

<ParamField body="service_key" type="string" required>
  Cheia ta de serviciu cu permisiuni „Teams Read‑only”
</ParamField>

<ParamField body="group_name" type="string">
  Filtrează rezultatele la utilizatorii dintr-un grup anume (opțional)
</ParamField>

<ParamField body="start_timestamp" type="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ă.
</ParamField>

<ParamField body="end_timestamp" type="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ă.
</ParamField>

<div id="example-request">
  ### Exemplu de solicitare
</div>

```bash theme={null}
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
```

<div id="response">
  ## Răspuns
</div>

<ResponseField name="userTableStats" type="array">
  Array de obiecte cu statistici despre utilizatori

  <Expandable title="Obiect statistici utilizator">
    <ResponseField name="name" type="string">
      Numele afișat al utilizatorului
    </ResponseField>

    <ResponseField name="email" type="string">
      Adresa de e-mail a utilizatorului
    </ResponseField>

    <ResponseField name="lastUpdateTime" type="string">
      Marcajul temporal al ultimei activități a utilizatorului, în format RFC 3339
    </ResponseField>

    <ResponseField name="apiKey" type="string">
      Valoarea hash a cheii API a utilizatorului
    </ResponseField>

    <ResponseField name="activeDays" type="number">
      Numărul de zile în care utilizatorul a fost activ în intervalul de timp interogat (definit de `start_timestamp` și `end_timestamp`). O zi este considerată activă dacă utilizatorul a avut orice acceptare Autocomplete, utilizare Cascade sau utilizare Command în acea zi.
    </ResponseField>

    <ResponseField name="disableCodeium" type="boolean">
      Indică dacă accesul la Windsurf a fost dezactivat pentru utilizator de către un administrator. Acest câmp este prezent doar dacă accesul a fost dezactivat explicit și va fi întotdeauna setat la true în acest caz.
    </ResponseField>

    <ResponseField name="role" type="string">
      Rolul utilizatorului în cadrul echipei (de ex., administrator, membru)
    </ResponseField>

    <ResponseField name="signupTime" type="string">
      Marcajul temporal al momentului în care utilizatorul s-a înregistrat, în format RFC 3339
    </ResponseField>

    <ResponseField name="lastAutocompleteUsageTime" type="string">
      Cel mai recent marcaj temporal la care a fost utilizată modalitatea Tab/Autocomplete, în format RFC 3339
    </ResponseField>

    <ResponseField name="lastChatUsageTime" type="string">
      Cel mai recent marcaj temporal la care a fost utilizată modalitatea Cascade, în format RFC 3339
    </ResponseField>

    <ResponseField name="lastCommandUsageTime" type="string">
      Cel mai recent marcaj temporal la care a fost utilizată modalitatea Command, în format RFC 3339
    </ResponseField>

    <ResponseField name="promptCreditsUsed" type="number">
      Numărul total de credite de prompt utilizate de acest utilizator în **ciclul de facturare curent**, afișat în **cenți** (1 credit = 100 cenți). Pentru a obține utilizarea efectivă a creditelor, împărțiți această valoare la 100. Această valoare **nu** este afectată de parametrii de cerere `start_timestamp` sau `end_timestamp`. Fereastra ciclului de facturare este indicată de câmpurile de nivel superior `billingCycleStart` și `billingCycleEnd`.
    </ResponseField>

    <ResponseField name="teamStatus" type="string">
      Starea de apartenență a utilizatorului la echipă. Valori posibile: `USER_TEAM_STATUS_UNSPECIFIED`, `USER_TEAM_STATUS_PENDING`, `USER_TEAM_STATUS_APPROVED`, `USER_TEAM_STATUS_REJECTED`. Rețineți că API-ul returnează toți utilizatorii, indiferent de starea în echipă, în timp ce interfața „Manage Members” afișează doar utilizatorii aprobați.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="billingCycleStart" type="string">
  Începutul ciclului de facturare curent, în format RFC 3339. Valorile `promptCreditsUsed` din `userTableStats` corespund utilizării din acest ciclu de facturare.
</ResponseField>

<ResponseField name="billingCycleEnd" type="string">
  Sfârșitul ciclului de facturare curent, în format RFC 3339. Valorile `promptCreditsUsed` din `userTableStats` corespund utilizării din acest ciclu de facturare.
</ResponseField>

<div id="example-response">
  ### Exemplu de răspuns
</div>

```json theme={null}
{
  "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"
}
```

<div id="error-responses">
  ## Răspunsuri de eroare
</div>

<ResponseField name="error" type="string">
  Mesaj de eroare care descrie problema apărută
</ResponseField>

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ă