> ## 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.

# Statistiques d'espace de travail

> Récupérer les analyses détaillées pour votre espace de travail

**Requête :**

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

**Réponse :**

```json theme={null}
[
  {
    "id": "ws_stat_123456789",
    "last_updated": "2024-01-15T10:30:00Z",
    "click_date": "2024-01-15",
    "total_clicks": 1250,
    "unique_visitors": 980,
    "scans_only": 50,
    "clicks_only": 1200,
    "chrome_clicks": 800,
    "ios_clicks": 400,
    "android_clicks": 200,
    "os_stats": {
      "iOS": 400,
      "Android": 200,
      "Windows": 500,
      "macOS": 150
    },
    "city_stats": {
      "New York": 200,
      "Los Angeles": 150,
      "Toronto": 100,
      "London": 80
    },
    "os_version_stats": {
      "iOS 17.0": 300,
      "iOS 16.5": 100,
      "Android 13": 120,
      "Android 12": 80
    },
    "lang_stats": {
      "en": 900,
      "fr": 150,
      "es": 100,
      "de": 50
    },
    "device_stats": {
      "mobile": 750,
      "desktop": 400,
      "tablet": 100
    },
    "browser_stats": {
      "Chrome": 800,
      "Safari": 300,
      "Firefox": 100,
      "Edge": 50
    },
    "country_stats": {
      "US": 650,
      "CA": 280,
      "UK": 180,
      "DE": 80
    },
    "device_and_os_stats": {
      "iPhone iOS": 400,
      "Android Phone": 200,
      "Windows Desktop": 500,
      "Mac Desktop": 150
    },
    "app_stats": {
      "Safari": 300,
      "Chrome Mobile": 400,
      "Chrome Desktop": 400
    },
    "device_type_stats": {
      "smartphone": 600,
      "desktop": 500,
      "tablet": 150
    },
    "from_app_stats": {
      "true": 300,
      "false": 950
    },
    "continent_stats": {
      "North America": 930,
      "Europe": 200,
      "Asia": 100,
      "Oceania": 20
    }
  }
]
```

## 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 ISO 8601, ex: 2024-01-01T00:00:00Z)
</ParamField>

<ParamField query="end_date" type="string">
  Date de fin pour les statistiques (format ISO 8601, ex: 2024-01-31T23:59:59Z)
</ParamField>

<ParamField query="max_days" type="integer">
  Nombre maximum de jours pour récupérer les statistiques (minimum: 1, maximum: 30)
</ParamField>

## Champs de réponse

<ResponseField name="id" type="string" required>
  Identifiant unique pour le statistics record
</ResponseField>

<ResponseField name="last_updated" type="string" required>
  Horodatage ISO 8601 de dernière mise à jour des statistiques
</ResponseField>

<ResponseField name="click_date" type="string" required>
  Date pour les statistiques (format YYYY-MM-DD)
</ResponseField>

<ResponseField name="total_clicks" type="integer" required>
  Nombre total de clics across all workspace links on this date
</ResponseField>

<ResponseField name="unique_visitors" type="integer" required>
  Nombre de visiteurs uniques sur tous les liens de l'espace de travail à cette date
</ResponseField>

<ResponseField name="scans_only" type="integer" required>
  Nombre de scans de code QR sans clics sur tous les liens de l'espace de travail à cette date
</ResponseField>

<ResponseField name="clicks_only" type="integer" required>
  Nombre de clics directs sans scans sur tous les liens de l'espace de travail à cette date
</ResponseField>

<ResponseField name="chrome_clicks" type="integer" required>
  Nombre de clics du navigateur Chrome sur tous les liens de l'espace de travail à cette date
</ResponseField>

<ResponseField name="ios_clicks" type="integer" required>
  Nombre de clics d'appareils iOS sur tous les liens de l'espace de travail à cette date
</ResponseField>

<ResponseField name="android_clicks" type="integer" required>
  Nombre de clics d'appareils Android sur tous les liens de l'espace de travail à cette date
</ResponseField>

<ResponseField name="os_stats" type="object">
  Statistiques décomposées par système d'exploitation across all workspace links

  <Expandable title="Operating system statistics">
    <ResponseField name="{os_name}" type="integer" required>
      Nombre de clics de ce système d'exploitation (nom du SE comme clé)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="city_stats" type="object">
  Statistiques décomposées par ville across all workspace links

  <Expandable title="City statistics">
    <ResponseField name="{city_name}" type="integer" required>
      Nombre de clics de cette ville (nom de la ville comme clé)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="os_version_stats" type="object">
  Statistiques décomposées par système d'exploitation version across all workspace links

  <Expandable title="OS version statistics">
    <ResponseField name="{version}" type="integer" required>
      Nombre de clics de cette version du SE (version comme clé)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="lang_stats" type="object">
  Statistiques décomposées par langue across all workspace links

  <Expandable title="Language statistics">
    <ResponseField name="{language_code}" type="integer" required>
      Nombre de clics de cette langue (code de langue comme clé)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="device_stats" type="object">
  Statistiques décomposées par type d'appareil across all workspace links

  <Expandable title="Device statistics">
    <ResponseField name="mobile" type="integer" required>
      Nombre de clics d'appareils mobiles
    </ResponseField>

    <ResponseField name="desktop" type="integer" required>
      Nombre de clics d'appareils de bureau
    </ResponseField>

    <ResponseField name="tablet" type="integer" required>
      Nombre de clics d'appareils tablettes
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="browser_stats" type="object">
  Statistiques décomposées par navigateur across all workspace links

  <Expandable title="Browser statistics">
    <ResponseField name="{browser_name}" type="integer" required>
      Nombre de clics de ce navigateur (nom du navigateur comme clé)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="country_stats" type="object">
  Statistiques décomposées par pays across all workspace links

  <Expandable title="Country statistics">
    <ResponseField name="{country_code}" type="integer" required>
      Nombre de clics de ce pays (code pays comme clé)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="device_and_os_stats" type="object">
  Statistiques décomposées par combinaison appareil et système d'exploitation across all workspace links

  <Expandable title="Device and OS statistics">
    <ResponseField name="{device_os}" type="integer" required>
      Nombre de clics de cette combinaison appareil-SE (appareil-SE comme clé)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="app_stats" type="object">
  Statistiques décomposées par application across all workspace links

  <Expandable title="Application statistics">
    <ResponseField name="{app_name}" type="integer" required>
      Nombre de clics de cette application (nom de l'app comme clé)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="device_type_stats" type="object">
  Statistiques décomposées par type d'appareil (detailed) across all workspace links

  <Expandable title="Device type statistics">
    <ResponseField name="{device_type}" type="integer" required>
      Nombre de clics de ce type d'appareil (device type as key)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="from_app_stats" type="object">
  Statistiques montrant les clics d'applications vs navigateurs web across all workspace links

  <Expandable title="App vs web statistics">
    <ResponseField name="true" type="integer" required>
      Nombre de clics d'applications mobiles
    </ResponseField>

    <ResponseField name="false" type="integer" required>
      Nombre de clics de navigateurs web
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="continent_stats" type="object">
  Statistiques décomposées par continent across all workspace links

  <Expandable title="Continent statistics">
    <ResponseField name="{continent_name}" type="integer" required>
      Nombre de clics de ce continent (nom du continent comme clé)
    </ResponseField>
  </Expandable>
</ResponseField>