API
Txosten publiko guztiak JSON dira. Ez dago gakorik eskatzeko eta ez konturik sortzeko. Gune batek txostena argitaratu badu, zenbakiak irakurri ahal izango ditu edonork, txostenaren orrialdea berak atera duen forma berean.
Hori da helburua, ez erosotasuna. Bereizi gabe eskuratu eta egiaztatu ezin duzun zenbaki bat pantaila-argazki bat da. Bi amaiera-puntu hauek dira gune honen aurrealdean dagoen adierazpena probagarria egiten dutenak.
Txostenaren datuak
Argitaratutako txosten baten atzean dagoen guztia: guztirakoak, grafikoa ateratzen den denbora-seriea eta iturria, orrialdea, herrialdea, arakatzailea, sistema, gailua eta kanpainaren banaketak.
| Parametroak | Balioak | Esanahi |
|---|---|---|
period | last24h · last7d · last30d · last90d · all |
Leihoa. Lehenespenez, last24h; ezagutu gabeko edozein gauza itzuliko da leihora errorea sortu ordez. |
granularity | hourly · daily |
Seriearen kutxa-tamaina. Utzi bertan behera eta periodo bakoitzak bere naturala erabiliko du - orduko egun batean, egunero egun bat baino luzeagoa den guztian. |
Erantzuna objektu bat da gako hauek dituena:
Bisitariak zuzenean
Gunean dagoena eta nondik etorri den. Soilik batuketak - inoiz ez bisitariaren id- a, inoiz ez bidea, inoiz ez pertsona bat identifika dezakeen ezer.
| Parametroak | Balioak | Esanahi |
|---|---|---|
minutes | 1–60 | Orain zenbat denbora igaro den zenbatzen da. Lehenespenez, 5; barrutitik kanpoko balioak atxikitzen dira, ez baztertzen. |
Honek Access-Control-Allow-Origin: * bidaltzen du eta hamar segundoz cache-an gordetzen du, webgune batek bere orrialdean bere zenbaki independentea txertatu ahal izateko — eta irakurle batek txostena ireki eta orrialdeak dioenaren kontra egiaztatu dezake.
Zertan fidatu daitekeen
- Ez dago autentifikaziorik, gakorik, ez da harpidetzeko tasa-mugarik. Bi amaiera-puntuak GET arruntak dira.
- Txostenak publikoa izan behar du. Jabeak argitaratu ez badu, bi amaiera-puntuek 404 itzuliko dute — gune ezezagun batek jasotzen duen erantzun bera, beraz APIak ez du inoiz adierazten gune pribatu bat existitzen dela.
- Ez da identifikaziorik eskaintzen, identifikaziorik ez delako gordetzen. IP helbideak ez dira inoiz idazten, eta bisitarien id-ak egunero gatzatzen dira eta ezin dira egunen artean batu.
- Atzo eta lehenagoko egunak eguneroko hash kate batean zigilatzen dira, zuk berraplika dezakezun. API honetako zenbakiak kate horretako zenbakiak dira.