Configurer la Stats API

Les traductions sont réalisées avec l'IA. Si certaines traductions sont incorrectes, veuillez nous le faire savoir sur hello@onelink.to

La Stats API est incluse dans Team Plus et Enterprise. Utilisez-la pour collecter automatiquement vos statistiques dans vos propres systèmes.
  1. Étape 1

    Créer une clé API

    Dans « Settings → Stats API », ajoutez un libellé si vous le souhaitez, comme l’outil qui utilisera la clé, puis choisissez Create. Copiez la clé quand elle apparaît : elle n’est affichée qu’une seule fois.
    Un compte peut avoir cinq clés. Donnez à chaque outil la sienne, pour pouvoir en révoquer une sans arrêter les autres.
  2. Étape 2

    Demander vos statistiques

    Chaque requête demande un type de statistiques sur une période, avec la clé dans l’en-tête Authorization, ou dans l’adresse sous la forme &api_key=… pour les outils qui ne peuvent pas définir d’en-têtes :
    curl -H "Authorization: Bearer ol_stats_…" \
  "https://api.onelink.to/public/stats/device?period=month"
    Remplacez device par redirect, country, referrer ou utm, et choisissez la période : day pour hier, month pour les 30 derniers jours, ou full pour les 400 derniers jours. La réponse liste chaque Onelink avec ses statistiques par jour. La référence complète, avec un exemple de réponse pour chaque type, se trouve dans « Settings → Stats API ».
  3. Étape 3

    Récupérer une fois par jour

    Les statistiques couvrent des journées complètes, comptées en UTC, et sont préparées peu après minuit UTC : une exécution après 01:00 UTC suffit. Chaque clé peut faire 50 requêtes par jour et 5 par minute.
    Si les statistiques sont encore en préparation, la réponse est 202 avec une liste vide. Réessayez au bout de cinq minutes. Cela arrive surtout lors de la première requête pour un type de statistiques.

Fonctionnalités de ce guide