Passer au contenu principal
GET
/
v1
/
stats
/
workspaces
Statistiques d'espace de travail
curl --request GET \
  --url https://api.taap.it/v1/stats/workspaces \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "last_updated": "<string>",
  "click_date": "<string>",
  "total_clicks": 123,
  "unique_visitors": 123,
  "scans_only": 123,
  "clicks_only": 123,
  "chrome_clicks": 123,
  "ios_clicks": 123,
  "android_clicks": 123,
  "os_stats": {
    "{os_name}": 123
  },
  "city_stats": {
    "{city_name}": 123
  },
  "os_version_stats": {
    "{version}": 123
  },
  "lang_stats": {
    "{language_code}": 123
  },
  "device_stats": {
    "mobile": 123,
    "desktop": 123,
    "tablet": 123
  },
  "browser_stats": {
    "{browser_name}": 123
  },
  "country_stats": {
    "{country_code}": 123
  },
  "device_and_os_stats": {
    "{device_os}": 123
  },
  "app_stats": {
    "{app_name}": 123
  },
  "device_type_stats": {
    "{device_type}": 123
  },
  "from_app_stats": {
    "true": 123,
    "false": 123
  },
  "continent_stats": {
    "{continent_name}": 123
  }
}
Requête :
cURL
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 : 
[
  {
    "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

​
Authorization
string
requis
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 ISO 8601, ex: 2024-01-01T00:00:00Z)
​
end_date
string
Date de fin pour les statistiques (format ISO 8601, ex: 2024-01-31T23:59:59Z)
​
max_days
integer
Nombre maximum de jours pour récupérer les statistiques (minimum: 1, maximum: 30)

​
Champs de réponse

​
id
string
requis
Identifiant unique pour le statistics record
​
last_updated
string
requis
Horodatage ISO 8601 de dernière mise à jour des statistiques
​
click_date
string
requis
Date pour les statistiques (format YYYY-MM-DD)
​
total_clicks
integer
requis
Nombre total de clics across all workspace links on this date
​
unique_visitors
integer
requis
Nombre de visiteurs uniques sur tous les liens de l’espace de travail à cette date
​
scans_only
integer
requis
Nombre de scans de code QR sans clics sur tous les liens de l’espace de travail à cette date
​
clicks_only
integer
requis
Nombre de clics directs sans scans sur tous les liens de l’espace de travail à cette date
​
chrome_clicks
integer
requis
Nombre de clics du navigateur Chrome sur tous les liens de l’espace de travail à cette date
​
ios_clicks
integer
requis
Nombre de clics d’appareils iOS sur tous les liens de l’espace de travail à cette date
​
android_clicks
integer
requis
Nombre de clics d’appareils Android sur tous les liens de l’espace de travail à cette date
​
os_stats
object
Statistiques décomposées par système d’exploitation across all workspace links
​
city_stats
object
Statistiques décomposées par ville across all workspace links
​
os_version_stats
object
Statistiques décomposées par système d’exploitation version across all workspace links
​
lang_stats
object
Statistiques décomposées par langue across all workspace links
​
device_stats
object
Statistiques décomposées par type d’appareil across all workspace links
​
browser_stats
object
Statistiques décomposées par navigateur across all workspace links
​
country_stats
object
Statistiques décomposées par pays across all workspace links
​
device_and_os_stats
object
Statistiques décomposées par combinaison appareil et système d’exploitation across all workspace links
​
app_stats
object
Statistiques décomposées par application across all workspace links
​
device_type_stats
object
Statistiques décomposées par type d’appareil (detailed) across all workspace links
​
from_app_stats
object
Statistiques montrant les clics d’applications vs navigateurs web across all workspace links
​
continent_stats
object
Statistiques décomposées par continent across all workspace links