API

Todos os informes públicos son tamén JSON. Non hai chave que solicitar nin conta que crear. Se un sitio publicou o seu informe, os seus números son lexíbeis para calquera, coa mesma forma que a páxina do informe.

Ese é o punto máis que unha conveniencia. Un número que non pode obter e comprobar independentemente é unha captura de pantalla. Estes dous puntos finais son o que fai que a afirmación na fronte deste sitio sexa testable.

Datos do informe

Todo o que hai detrás dun informe publicado: totais, a serie temporal da que se obtén o gráfico e a fonte, páxina, país, navegador, sistema, dispositivo e desgloses de campañas.

GET https://visits.report/r/507de85247a64071f4e5583f9ba2583b/data/?period=last24h&granularity=hourly
Parámetros Valores Significado
periodlast24h · last7d · last30d · last90d · all A fiestra. Por omisión é last24h; calquera cousa non recoñecida regresa a ela no canto de dar erros.
granularityhourly · daily O tamaño do cubo para a serie. Omite e cada período usa o seu natural: hora a hora para un día, día a día para todo o que sexa máis longo.

A resposta é un obxecto con estas chaves:

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

Visitantes en directo

Quen está no sitio agora e de onde vén. Só agregados - nunca un id de visitante, nunca unha rota, nunca nada que poida identificar a unha persoa.

GET https://visits.report/r/507de85247a64071f4e5583f9ba2583b/live/?minutes=5
Parámetros Valores Significado
minutes1–60 Canto tempo atrás conta como agora. Por omisión 5; os valores fóra do rango son acurtados, non rexeitados.

Este envía Access- Control- Allow- Origin: * e cachéase durante dez segundos, de xeito que un sitio pode incorporar o seu propio número de contas independentes na súa propia páxina, e un lector pode abrir o informe e comprobalo contra o que a páxina afirma.

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

Co que podes contar

  • Sen autenticación, sen chave, sen límite de velocidade para rexistrarse. Ambos os puntos finais son GETs simples.
  • Un informe debe ser público. Se o seu dono non o publicou, ambos os puntos finais devolven 404, a mesma resposta que recibe un sitio descoñecido, polo que a API nunca revela que existe un sitio privado.
  • Non se serve nada identificativo, porque non se garda nada identificativo. Os enderezos IP nunca se escriben, e os id dos visitantes son salgados diariamente e non se poden unir entre días.
  • Onte e antes están selados nunha cadea de hash diaria que pode recalcular vostede mesmo. Os números nesta API son os números desa cadea.

Como verificar a cadea manualmente →

Made by @nadermx