Die Stats API einrichten

Übersetzungen werden mit KI erstellt. Falls einige Übersetzungen fehlerhaft sind, teilen Sie es uns bitte unter hello@onelink.to mit

Die Stats API ist in Team Plus und Enterprise enthalten. Nutzen Sie sie, um Ihre Statistiken automatisch in Ihren eigenen Systemen zu sammeln.
  1. Schritt 1

    Einen API-Schlüssel erstellen

    Fügen Sie unter „Settings → Stats API“ bei Bedarf eine Bezeichnung hinzu, etwa das Tool, das den Schlüssel verwenden wird, und wählen Sie Create. Kopieren Sie den Schlüssel, sobald er erscheint: Er wird nur einmal angezeigt.
    Ein Konto kann fünf Schlüssel haben. Geben Sie jedem Tool einen eigenen, damit Sie einen widerrufen können, ohne die anderen zu stoppen.
  2. Schritt 2

    Ihre Statistiken abfragen

    Jede Anfrage fragt eine Art von Statistiken für einen Zeitraum ab, mit dem Schlüssel im Header Authorization oder, für Tools, die keine Header setzen können, in der Adresse als &api_key=…:
    curl -H "Authorization: Bearer ol_stats_…" \
  "https://api.onelink.to/public/stats/device?period=month"
    Ersetzen Sie device durch redirect, country, referrer oder utm, und wählen Sie den Zeitraum: day für gestern, month für die letzten 30 Tage oder full für die letzten 400 Tage. Die Antwort listet jeden Onelink mit seinen Statistiken pro Tag. Die vollständige Referenz, mit einer Beispielantwort für jede Art, finden Sie unter „Settings → Stats API“.
  3. Schritt 3

    Einmal täglich abrufen

    Die Statistiken umfassen abgeschlossene Tage, gezählt in UTC, und werden kurz nach Mitternacht UTC aufbereitet; ein Abruf nach 01:00 UTC genügt also. Jeder Schlüssel darf 50 Anfragen pro Tag und 5 pro Minute stellen.
    Werden die Statistiken noch aufbereitet, lautet die Antwort 202 mit einer leeren Liste. Versuchen Sie es nach fünf Minuten erneut. Das passiert meist bei der ersten Anfrage für eine Art von Statistiken.

Funktionen in dieser Anleitung