API
모든 공개 보고서는 JSON입니다. 요청할 키가 없고 만들 계정도 없습니다. 사이트가 보고서를 게시하면 보고서 페이지 자체가 그려진 것과 동일한 형태로 누구나 읽을 수 있습니다.
이것이 편의성이 아닌 중요한 점입니다. 독립적으로 가져와서 확인할 수 없는 숫자는 스크린샷입니다. 이 두 종료점은 이 사이트의 앞면에 주장을 테스트 가능하게 만듭니다.
보고서 데이터
총계, 차트가 그려진 시계열, 소스, 페이지, 국가, 브라우저, 시스템, 장치 및 캠페인 분석 등 게시된 보고서 뒤에 있는 모든 정보를 확인할 수 있습니다.
GET https://visits.report/r/507de85247a64071f4e5583f9ba2583b/data/?period=last24h&granularity=hourly
| 파라미터 | 값 | 의미 |
|---|---|---|
period | last24h · last7d · last30d · last90d · all |
창. 기본값은 last24h 입니다. 인식되지 않은 모든 것은 오류가 발생하는 대신 이 창으로 돌아갑니다. |
granularity | hourly · daily |
시리즈의 버킷 크기. 생략하면 각 기간은 자연적인 기간을 사용합니다. 하루는 시간당, 긴 모든 것은 일일. |
응답은 다음과 같은 키를 가진 하나의 객체입니다.
{
"totals": { "pageviews": 0, "visitors": 0, "visits": 0, ... },
"series": [ { "label": "...", "pageviews": 0, "visitors": 0 }, ... ],
"sources": [ ... ], "pages": [ ... ],
"countries": [ ... ], "browsers": [ ... ],
"systems": [ ... ], "devices": [ ... ],
"campaigns": [ ... ], "live": 0
}
라이브 방문자
현재 사이트에 있는 사람과 그들이 어디에서 왔는지. 집계만 — 방문자 ID, 경로, 사람을 분리할 수있는 어떤 것도 없습니다.
GET https://visits.report/r/507de85247a64071f4e5583f9ba2583b/live/?minutes=5
| 파라미터 | 값 | 의미 |
|---|---|---|
minutes | 1–60 | 현재로 얼마나 돌아가야 하는지를 나타냅니다. 기본값은 5입니다. 범위 밖의 값은 클램프되고 거부되지 않습니다. |
이것은 Access-Control-Allow-Origin: * 를 보내고 10초 동안 캐시를 하게 되는데, 이렇게 하면 사이트가 자신의 페이지에 독립적으로 계산된 실시간 숫자를 삽입할 수 있고, 독자는 보고서를 열어 페이지가 주장하는 것과 비교하여 확인할 수 있습니다.
{
"domain": "visits.report", "verified": true, "minutes": 5,
"visitors": 0,
"sources": [ ... ],
"countries": [ ... ],
"report_url": "https://visits.report/r/…/"
}
믿을 수 있는 것
- 인증이나 키, 가입할 수 있는 속도 제한이 없습니다. 두 엔드포인트 모두 간단한 GET입니다.
- 보고서는 공개되어야 합니다. 소유자가 보고서를 게시하지 않은 경우 두 엔드포인트 모두 404를 반환합니다. 이는 알 수 없는 사이트가 받는 답변과 동일하므로 API는 비공개 사이트가 존재한다는 사실을 밝히지 않습니다.
- IP 주소는 절대로 기록되지 않으며, 방문자 ID는 매일 소금으로 처리되며, 날마다 합쳐지지 않습니다.
- 어제와 이전은 직접 재계산할 수 있는 일일 해시 체인에 밀봉됩니다. 이 API의 숫자는 해당 체인의 숫자입니다.