API

Fiecare raport public este, de asemenea, JSON. Nu există cheie de a solicita și nici un cont de a crea — dacă un site a publicat raportul său, numerele sale sunt legibile de oricine, în aceeași formă de la pagina raportului în sine.

Acesta este punctul în loc de o conveniență. Un număr pe care nu-l poti obține și verifica independent este o imagine de screenshot. Aceste două puncte sunt ceea ce face reclamarea pe partea din față a acestui site testabil.

Raportul datelor

Tot ce se află în spatele unui raport publicat: total, seria temporală, este desenat de la, și sursa, pagina, țara, browser, sistem, dispozitiv și defalcare de campanie.

GET https://visits.report/r/507de85247a64071f4e5583f9ba2583b/data/?period=last24h&granularity=hourly

Parametrul	Valori	Înseamnă
`period`	`last24h` · `last7d` · `last30d` · `last90d` · `all`	Fereastra. Defectul este de 24 ore; orice nu este recunoscut se retrage la ea, nu eroare.
`granularity`	`hourly` · `daily`	Dimensiune a bucketului pentru seria. Omite-l şi fiecare perioadă foloseşte unul natural — o oră pentru o zi, zilnic pentru tot ce mai mult.

Răspunsul este un obiect cu aceste chei:

{ "totals": { "pageviews": 0, "visitors": 0, "visits": 0, ... }, "series": [ { "label": "...", "pageviews": 0, "visitors": 0 }, ... ], "sources": [ ... ], "pages": [ ... ], "countries": [ ... ], "browsers": [ ... ], "systems": [ ... ], "devices": [ ... ], "campaigns": [ ... ], "live": 0 }

Vizitatori în direct

Agregează doar: niciodată un id de vizitator, niciodată un drum, niciodată ceva care să poată adăuga o persoană.

GET https://visits.report/r/507de85247a64071f4e5583f9ba2583b/live/?minutes=5

Parametrul	Valori	Înseamnă
`minutes`	1–60	Cât de departe contează acum. Valorile implicite la 5; în afara intervalului sunt blocate, nu respinse.

Acesta trimite acces-Control-Allow-Origin: * și cacheuri pentru zece secunde, astfel încât un site poate îngloba propriul său număr live-contat independent în propria sa pagină — și un cititor poate deschide raportul și verifica împotriva ceea ce pagina pretinde.

{ "domain": "visits.report", "verified": true, "minutes": 5, "visitors": 0, "sources": [ ... ], "countries": [ ... ], "report_url": "https://visits.report/r/…/" }

La ce te poţi baza

Fără autentificare, fără cheie, fără limită de rată pentru care să se înscrie. Ambele puncte sunt simple GET.
Un raport trebuie să fie public. Dacă proprietarul său nu a publicat-o, ambele puncte finale returnează 404 – același răspuns devine un site necunoscut, astfel încât API nu dezvăluie niciodată că există un site privat.
Nimic care să identifice este servit, deoarece nimic care să identifice este stocat. Adresele IP nu sunt niciodată scrise, iar id-urile vizitatorilor sunt sărate zilnic și nu pot fi alăturate în zilele noastre.
Ieri și mai devreme sunt sigilate într-un lanț zilnic de haș, puteți recomputa. Numerele din această API sunt numerele în acel lanț.

Cum să verificăm lanțul cu mână →