API: er
Varje offentlig Rapportera är också JSON. Det finns ingen nyckel att begära och inget konto att skapa – om en webbplats har publicerat sin Rapportera, dess nummer är läsbara av någon, i samma form som rapporten sidan själv hämtar från.
Det är poängen snarare än en bekvämlighet. Ett nummer du inte kan hämta och kontrollera självständigt är en skärmdump. Dessa två endpoints är vad gör påståendet på framsidan av denna webbplats testable.
Uppgifter om rapporten
Allt bakom en publicerad Rapportera: totals, tidsserien diagrammet ritas från, och källan, sidan, land, webbläsare, system, enhet och kampanj haverier.
| Parameter | Värden | Innebörd |
|---|---|---|
period | last24h · last7d · last30d · last90d · all |
Fönstret. Standarder för att hålla i 24h; allt som inte är erkänt faller tillbaka till det istället för att fela. |
granularity | hourly · daily |
Glöm den och varje period använder sin naturliga – varje dag varje dag, varje dag för allt längre. |
Svaret är ett objekt med dessa nycklar:
Livebesökare
Vem är på platsen just nu, och var de kom ifrån. Aggregerar bara - aldrig en besökare ID, aldrig en väg, aldrig något som kan peka ut en person.
| Parameter | Värden | Innebörd |
|---|---|---|
minutes | 1–60 | Hur långt tillbaka räknas som nu. Standarder till 5; värden utanför intervallet är fastklämda, inte förkastade. |
Denna skickar Access-Control-Tillåt-Ursprung: * och caches för tio sekunder, så en webbplats kan bädda in sitt eget oberoende-räknad levande nummer på sin egen sida - och en läsare kan öppna rapporten och kontrollera den mot vad sidan hävdar.
Vad du kan räkna med
- Ingen behörighetskontroll, ingen nyckel, ingen hastighetsgräns att registrera sig för. Båda effektmåtten är enkla GET.
- En Rapportera måste vara offentlig. Om ägaren inte har publicerat den, båda endpoints returnera 404 - samma svar en okänd webbplats får, så API aldrig avslöjar att en privat webbplats finns.
- Inget identifierings- tillhandahålls, eftersom inget identifiering lagras. IP-adresser skrivs aldrig ner, och besöks-ID saltas dagligen och kan inte sammanfogas över dagar.
- Igår och tidigare är förseglade i en daglig hashkedja kan du omberäkna dig själv. Siffrorna i detta API är siffrorna i den kedjan.