Passer au contenu principal
GET
https://api.taap.it
/
v1
/
stats
/
workspaces
/
summary
Résumé des statistiques d'espace de travail
curl --request GET \
  --url https://api.taap.it/v1/stats/workspaces/summary \
  --header 'Authorization: <authorization>'
{
  "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/workspaces/summary?start_date=2024-01-01&end_date=2024-01-31' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
Réponse : 
{
  "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

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

​
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

​
total_clicks
integer
required
Nombre total de clics across all links in the workspace
​
top_countries
array
required
Tableau des pays les plus actifs par nombre de clics across all workspace links
​
top_devices
array
required
Tableau des appareils les plus actifs par nombre de clics across all workspace links
​
top_browsers
array
required
Tableau des navigateurs les plus actifs par nombre de clics across all workspace links
​
qr_code_usage
integer
required
Nombre total de scans de codes QR sur tous les liens de l’espace de travail
​
date_range
object
Plage de dates pour les statistiques