> ## 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 de lien

> Récupérer un résumé des métriques clés pour un lien spécifique

**Requête :**

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

**Réponse :**

```json theme={null}
{
  "link_id": "link_987654321",
  "total_clicks": 1250,
  "top_countries": [
    {"name": "US", "count": 650},
    {"name": "CA", "count": 280},
    {"name": "UK", "count": 180}
  ],
  "top_devices": [
    {"name": "mobile", "count": 750},
    {"name": "desktop", "count": 400},
    {"name": "tablet", "count": 100}
  ],
  "top_browsers": [
    {"name": "Chrome", "count": 800},
    {"name": "Safari", "count": 300},
    {"name": "Firefox", "count": 100}
  ],
  "qr_code_usage": 45,
  "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 chemin

<ParamField path="link_id" type="string" required>
  Identifiant unique pour le link
</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="link_id" type="string" required>
  Identifiant unique pour le link
</ResponseField>

<ResponseField name="total_clicks" type="integer" required>
  Nombre total de clics on the link
</ResponseField>

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

  <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

  <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

  <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 de fois que le code QR a été scanné
</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>