Passer au contenu principal
GET
/
v1
/
stats
/
links
/
{id}
/
summary
Résumé des statistiques de lien
curl --request GET \
  --url https://api.taap.it/v1/stats/links/{id}/summary \
  --header 'Authorization: <authorization>'
{
  "link_id": "<string>",
  "total_clicks": 123,
  "top_countries": [
    {
      "name": "<string>",
      "count": 123
    }
  ],
  "top_devices": [
    {
      "name": "<string>",
      "count": 123
    }
  ],
  "top_browsers": [
    {
      "name": "<string>",
      "count": 123
    }
  ],
  "qr_code_usage": 123,
  "date_range": {
    "start": "<string>",
    "end": "<string>"
  }
}
Requête :
cURL
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 : 
{
  "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

​
Authorization
string
requis
Token Bearer pour l’authentification API. Format : Bearer YOUR_API_KEY

​
Paramètres de chemin

​
link_id
string
requis
Identifiant unique pour le link

​
Paramètres de requête

​
start_date
string
Date de début pour les statistiques (format YYYY-MM-DD)
​
end_date
string
Date de fin pour les statistiques (format YYYY-MM-DD)

​
Champs de réponse

​
link_id
string
requis
Identifiant unique pour le link
​
total_clicks
integer
requis
Nombre total de clics on the link
​
top_countries
array
requis
Tableau des pays les plus actifs par nombre de clics
​
top_devices
array
requis
Tableau des appareils les plus actifs par nombre de clics
​
top_browsers
array
requis
Tableau des navigateurs les plus actifs par nombre de clics
​
qr_code_usage
integer
requis
Nombre de fois que le code QR a été scanné
​
date_range
object
Plage de dates pour les statistiques