API
Každá verejná správa je tiež JSON, nie je potrebné vyžiadať si kľúč a nie je potrebné vytvoriť si účet — ak stránka zverejnila správu, jej čísla sú čitateľné pre každého, v rovnakom tvare, z ktorého je čerpaná samotná stránka správy.
To je podstata, nie pohodlie. Číslo, ktoré nemôžete nezávisle získať a skontrolovať, je snímka obrazovky. Tieto dva koncové body sú to, čo robí tvrdenie na prednej strane tejto stránky testovatelné.
Údaje správy
Všetko, čo sa skrýva za zverejneným prehľadom: súčty, časové rady, z ktorých je graf vytvorený, a rozdelenie podľa zdroja, stránky, krajiny, prehliadača, systému, zariadenia a kampane.
| Parameter | Hodnoty | Význam |
|---|---|---|
period | last24h · last7d · last30d · last90d · all |
Predvolené nastavenie je last24h; čokoľvek nerozpoznané sa vráti späť do okna namiesto chyby. |
granularity | hourly · daily |
Vynechajte ho a každé obdobie použije svoje prirodzené obdobie – hodinové pre deň, denné pre všetko dlhšie.Hourly for a day, daily for everything longer. |
Odpoveď je jeden objekt s týmito kľúčmi:
Živí návštevníci
Kto je na stránke práve teraz a odkiaľ prišiel. Iba agregované údaje – nikdy nie ID návštevníka, nikdy nie cesta, nikdy nič, čo by mohlo identifikovať osobu.
| Parameter | Hodnoty | Význam |
|---|---|---|
minutes | 1–60 | Predvolená hodnota je 5; hodnoty mimo rozsahu sú zachytávané, nie odmietané. |
Tento odošle Access-Control-Allow-Origin: * a cache na desať sekúnd, takže stránka môže vložiť svoje vlastné nezávisle počítané živé číslo na vlastnú stránku - a čitateľ môže otvoriť správu a skontrolovať to, čo stránka tvrdí.
Na čo sa môžete spoľahnúť
- Žiadne overovanie, žiadny kľúč, žiadny limit rýchlosti, na ktorú sa treba prihlásiť. Obidva koncové body sú obyčajné GETy.
- Ak vlastník správy správu nezverejnil, obidva koncové body vrátia chybu 404 – rovnakú odpoveď, akú dostane neznáma stránka, takže rozhranie API nikdy neodhaľuje, že súkromná stránka existuje.
- IP adresy sa nikdy nezapisujú a návštevníkove ID sú denne soľované a nemôžu byť spojené v priebehu dní, takže sa nedá povedať, že by sa návštevník na stránke pohyboval.
- Včera a skôr sú zapečatené v dennom hash reťazci, ktorý môžete prepočítať sami.Čísla v tomto API sú čísla v tomto reťazci.