Krajnja točka REST API-ja

GET /v1/pulse

Današnji puls, usporedba s jučerašnjim danom i unutardnevne krivulje u intervalima od 15 minuta.

Zahtjev

GET https://api.nowmetrix.com/v1/pulse?site=TRACKER_ID

Pomoću funkcije Pulse možete odgovoriti na korisnije pitanje od „Koliki nam je promet?”: je li današnji promet iznad ili ispod uobičajenog obrasca za ovaj dan u tjednu i ovo vrijeme?

Autentikacija

Potreban je API ključ u zaglavlju Authorization, u obliku Authorization: Bearer nm_YOUR_KEY.

Parametri upita

Naziv Vrsta Obavezno Opis
site string obavezno ID trackera. API ključ mora imati pristup tom trackeru.

Primjer cURL-a

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

Primjer odgovora

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30Z",
  "timezone": "Europe/Zurich",
  "pulse": {
    "available": true,
    "reason": null,
    "delta_percent": 12,
    "days_counted": 8,
    "is_provisional": false,
    "minute_of_day": 865,
    "metrics": {
      "pageviews": {
        "today": 48215,
        "avg": 43040,
        "delta_percent": 12
      },
      "visitors": {
        "today": 31890,
        "avg": 29620,
        "delta_percent": 8
      },
      "active_users": {
        "today": 128,
        "avg": 104,
        "delta_percent": 23
      }
    },
    "baseline": {
      "snapshot_time": "14:25",
      "aggregation": "median",
      "combination": "mean_of_deltas",
      "days_counted": 8,
      "samples": [
        {
          "date": "2026-06-19",
          "pageviews": 42110,
          "visitors": 29100,
          "active_users": 98
        }
      ]
    }
  },
  "yesterday_vs_day_before": {
    "yesterday": {
      "date": "2026-06-25",
      "pageviews": 77480,
      "visitors": 50195
    },
    "day_before": {
      "date": "2026-06-24",
      "pageviews": 81240,
      "visitors": 53210
    },
    "delta_percent": {
      "pageviews": -5,
      "visitors": -6
    }
  },
  "chart": {
    "interval_minutes": 15,
    "today_date": "2026-06-26",
    "yesterday_date": "2026-06-25",
    "average_basis_days": 8,
    "average_method": "median_same_weekday",
    "pageviews": {
      "today": [
        {
          "time": "08:00",
          "value": 920
        },
        {
          "time": "08:15",
          "value": 1110
        }
      ],
      "yesterday": [
        {
          "time": "08:00",
          "value": 870
        }
      ],
      "average": [
        {
          "time": "08:00",
          "value": 810
        }
      ]
    },
    "visitors": {
      "today": [
        {
          "time": "08:00",
          "value": 620
        }
      ],
      "yesterday": [
        {
          "time": "08:00",
          "value": 580
        }
      ],
      "average": [
        {
          "time": "08:00",
          "value": 540
        }
      ]
    }
  }
}

Polja odgovora

Polje Vrsta Opis
site string ID trackera upotrijebljen u zahtjevu.
updated_at string Vremenska oznaka u UTC-u za trenutak generiranja sadržaja.
timezone string Vremenska zona trackera koja se upotrebljava za određivanje lokalnih datuma.
pulse.available boolean Je li dostupno dovoljno povijesnih podataka za izračun pulsa.
pulse.reason string|null Razlog zbog kojeg puls nije dostupan.
pulse.delta_percent integer|null Ukupna postotna razlika u odnosu na referentnu vrijednost.
pulse.days_counted integer Broj dana uključenih u referentnu vrijednost.
pulse.is_provisional boolean Je li rezultat pulsa privremen.
pulse.minute_of_day integer Trenutačna minuta lokalnog dana upotrijebljena za usporedbu.
pulse.metrics.pageviews object Današnja vrijednost, prosjek i delta_percent za preglede stranica.
pulse.metrics.visitors object Današnja vrijednost, prosjek i delta_percent za posjetitelje.
pulse.metrics.active_users object Današnja vrijednost, prosjek i delta_percent za aktivne korisnike.
pulse.baseline object Metapodaci referentne vrijednosti i uzorci dana upotrijebljeni za izračun pulsa.
yesterday_vs_day_before object Usporedba dovršenih dana za preglede stranica i posjetitelje.
chart object Serije u intervalima od 15 minuta za danas, jučer i prosjek, podijeljene na preglede stranica i posjetitelje.

Svježina podataka i predmemoriranje

Odgovori se za svaki tracker mikrospremaju u predmemoriju na 30 sekundi, uz 90-sekundni prozor za posluživanje zastarjelih odgovora radi zaštite od naglih opterećenja.

Pogreške

HTTP Kôd Opis
400 site_required Nedostaje obavezni parametar site.
401 missing_token Nedostaje zaglavlje Authorization.
401 invalid_token Token nije valjan ili je opozvan.
403 site_not_authorized API ključ nema pristup ovom trackeru.
429 rate_limit_exceeded Prekoračeno je ograničenje broja zahtjeva.
503 redis_unavailable Pozadinski sustav za podatke u stvarnom vremenu trenutačno nije dostupan. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}