Endpoint REST API

GET /v1/overview

Dzienne odsłony i wizyty za ostatnie N zakończonych dni.

Żądanie

GET https://api.nowmetrix.com/v1/overview?site=TRACKER_ID&days=7

To zwięzły endpoint przeznaczony do raportów dotyczących trendów, importu do narzędzi BI, eksportu do arkuszy kalkulacyjnych oraz prostych podsumowań tygodniowych lub miesięcznych.

Uwierzytelnianie

Klucz API należy umieścić w nagłówku Authorization w postaci: Authorization: Bearer nm_YOUR_KEY.

Parametry zapytania

Nazwa Typ Wymagany Opis
site string wymagany Identyfikator trackera. Klucz API musi mieć dostęp do tego trackera.
days integer opcjonalny Liczba dni do zwrócenia. Wartości są ograniczane do zakresu 1–30. Wartość domyślna: 30.

Przykład cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/overview?site=TRACKER_ID&days=7"

Przykładowa odpowiedź

{
  "site": "TRACKER_ID",
  "timezone": "Europe/Zurich",
  "range": {
    "from": "2026-06-20",
    "to": "2026-06-26",
    "days": 7
  },
  "daily": [
    {
      "date": "2026-06-20",
      "pageviews": 81240,
      "visits": 53210
    },
    {
      "date": "2026-06-21",
      "pageviews": 77480,
      "visits": 50195
    },
    {
      "date": "2026-06-22",
      "pageviews": 48215,
      "visits": 31890
    }
  ],
  "totals": {
    "pageviews": 206935,
    "visits": 135295
  }
}

Pola odpowiedzi

Pole Typ Opis
site string Identyfikator trackera użyty w żądaniu.
timezone string Strefa czasowa trackera używana do ustalania dat lokalnych.
range.from string Pierwsza data w zwróconej tablicy dziennej.
range.to string Ostatnia data w zwróconej tablicy dziennej.
range.days integer Liczba zwróconych wierszy dziennych.
daily[] array<object> Wiersze dzienne posortowane rosnąco według daty.
daily[].date string Data w formacie YYYY-MM-DD.
daily[].pageviews integer Liczba odsłon w danym dniu.
daily[].visits integer Liczba wizyt w danym dniu.
totals.pageviews integer Suma odsłon ze zwróconych wierszy dziennych.
totals.visits integer Suma wizyt ze zwróconych wierszy dziennych.

Aktualność danych i buforowanie

Odpowiedzi są mikrobuforowane dla każdego trackera i każdej wartości parametru days przez 60 sekund. Dodatkowo stosowane jest krótkie okno tolerowania nieaktualnych danych w celu ochrony przed nagłymi seriami żądań.

Błędy

HTTP Kod Opis
400 site_required Brakuje wymaganego parametru site.
401 missing_token Brakuje nagłówka Authorization.
401 invalid_token Token jest nieprawidłowy lub został unieważniony.
403 site_not_authorized Klucz API nie ma dostępu do tego trackera.
429 rate_limit_exceeded Przekroczono limit żądań.
503 redis_unavailable Backend realtime jest tymczasowo niedostępny. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}