API
Jeder öffentliche Melden ist auch JSON. Es gibt keinen Schlüssel zu verlangen und kein Konto zu erstellen - wenn eine Website seinen Melden veröffentlicht hat, sind seine Zahlen von jedermann lesbar, in der gleichen Form, die die Report-Seite selbst zieht aus.
Das ist der Punkt, anstatt ein Komfort. Eine Zahl, die Sie nicht holen und unabhängig prüfen können, ist ein Screenshot. Diese beiden Endpunkte sind, was den Anspruch auf der Vorderseite dieser Website testbar macht.
Daten melden
Alles hinter einem veröffentlichten Melden: Summen, die Zeitreihe, aus der das Diagramm gezeichnet wird, und die Quelle, Seite, Land, Browser, System, Gerät und Kampagnen-Bruch.
| Parameter | Werte | Bedeutung |
|---|---|---|
period | last24h · last7d · last30d · last90d · all |
Das Fenster. Standardwerte bis last24h; alles Unerkannte fällt zurück, anstatt Fehler zu machen. |
granularity | hourly · daily |
Eimergröße für die Serie. Lassen Sie es und jede Periode verwendet seine natürliche ein — stündlich für einen Tag, täglich für alles länger. |
Die Antwort ist ein Objekt mit diesen Schlüsseln:
Live-Besucher
Wer ist auf der Website gerade jetzt, und wo sie herkommen. Aggregate nur – nie ein Besucher-ID, nie ein Weg, nie etwas, das eine Person heraus, unterscheiden könnte.
| Parameter | Werte | Bedeutung |
|---|---|---|
minutes | 1–60 | Wie weit zurück zählt wie jetzt. Standardwerte auf 5; Werte außerhalb des Bereichs werden eingeklemmt, nicht abgelehnt. |
Dieser sendet Access-Control-Allow-Origin: * und Caches für zehn Sekunden, so dass eine Site ihre eigene unabhängig gezählte Live-Nummer in ihre eigene Seite einbetten kann – und ein Leser kann den Melden öffnen und ihn an dem überprüfen, was die Seite behauptet.
Worauf Sie sich verlassen können
- Keine Authentifizierung, kein Schlüssel, keine Rate Grenze für die Anmeldung. Beide Endpunkte sind einfache GETs.
- Ein Melden muss öffentlich sein. Wenn sein Besitzer ihn nicht veröffentlicht hat, geben beide Endpunkte 404 zurück – dieselbe Antwort bekommt eine unbekannte Seite, so dass die API nie enthüllt, dass eine private Seite existiert.
- Es wird nichts Identifizierendes serviert, weil nichts Identifizierendes gespeichert wird. IP-Adressen werden nie aufgeschrieben, Besucher-IDs werden täglich gesalzen und können nicht über Tage miteinander verbunden werden.
- Gestern und früher sind in einer täglichen Hash-Kette versiegelt, die Sie sich selbst rekompilieren können. Die Zahlen in dieser API sind die Zahlen in dieser Kette.