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

# Résumé des statistiques d'espace de travail

> Récupérer un résumé des métriques clés pour votre espace de travail

**Requête :**

```bash cURL theme={null}
curl -X GET 'https://api.taap.it/v1/stats/workspaces/summary?start_date=2024-01-01&end_date=2024-01-31' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
```

**Réponse :**

```json theme={null}
{
  "total_clicks": 15750,
  "top_countries": [
    {"name": "US", "count": 8250},
    {"name": "CA", "count": 3150},
    {"name": "UK", "count": 2250}
  ],
  "top_devices": [
    {"name": "mobile", "count": 9450},
    {"name": "desktop", "count": 5250},
    {"name": "tablet", "count": 1050}
  ],
  "top_browsers": [
    {"name": "Chrome", "count": 10000},
    {"name": "Safari", "count": 3750},
    {"name": "Firefox", "count": 1500}
  ],
  "qr_code_usage": 525,
  "date_range": {
    "start": "2024-01-01",
    "end": "2024-01-31"
  }
}
```

## Autorisation

<ParamField header="Authorization" type="string" required>
  Token Bearer pour l'authentification API. Format : `Bearer YOUR_API_KEY`
</ParamField>

## Paramètres de requête

<ParamField query="start_date" type="string">
  Date de début pour les statistiques (format YYYY-MM-DD)
</ParamField>

<ParamField query="end_date" type="string">
  Date de fin pour les statistiques (format YYYY-MM-DD)
</ParamField>

## Champs de réponse

<ResponseField name="total_clicks" type="integer" required>
  Nombre total de clics across all links in the workspace
</ResponseField>

<ResponseField name="top_countries" type="array" required>
  Tableau des pays les plus actifs par nombre de clics across all workspace links

  <Expandable title="Country object properties">
    <ResponseField name="name" type="string" required>
      Code pays (ISO 3166-1 alpha-2)
    </ResponseField>

    <ResponseField name="count" type="integer" required>
      Nombre de clics de ce pays
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="top_devices" type="array" required>
  Tableau des appareils les plus actifs par nombre de clics across all workspace links

  <Expandable title="Device object properties">
    <ResponseField name="name" type="string" required>
      Type d'appareil (mobile, bureau, tablette)
    </ResponseField>

    <ResponseField name="count" type="integer" required>
      Nombre de clics de ce type d'appareil
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="top_browsers" type="array" required>
  Tableau des navigateurs les plus actifs par nombre de clics across all workspace links

  <Expandable title="Browser object properties">
    <ResponseField name="name" type="string" required>
      Nom du navigateur (Chrome, Safari, Firefox, etc.)
    </ResponseField>

    <ResponseField name="count" type="integer" required>
      Nombre de clics de ce navigateur
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="qr_code_usage" type="integer" required>
  Nombre total de scans de codes QR sur tous les liens de l'espace de travail
</ResponseField>

<ResponseField name="date_range" type="object">
  Plage de dates pour les statistiques

  <Expandable title="Date range properties">
    <ResponseField name="start" type="string" required>
      Date de début de la période de statistiques
    </ResponseField>

    <ResponseField name="end" type="string" required>
      Date de fin de la période de statistiques
    </ResponseField>
  </Expandable>
</ResponseField>