REST API galapunkts

GET /v1/pulse

Šodienas Pulse rādītājs, salīdzinājums ar vakardienu un 15 minūšu dienas līknes.

Pieprasījums

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

Izmantojiet Pulse, lai atbildētu uz noderīgāku jautājumu nekā „Cik liela ir mūsu datplūsma?” — vai šodienas rādītāji pārsniedz šai nedēļas dienai un laikam ierasto līmeni, vai ir zem tā?

Autentifikācija

Nepieciešama API atslēga Authorization galvenē: Authorization: Bearer nm_YOUR_KEY.

Vaicājuma parametri

Nosaukums Tips Obligāts Apraksts
site string obligāts Tracker ID. API atslēgai ir jābūt piekļuvei šim tracker ID.

cURL piemērs

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

Atbildes piemērs

{
  "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
        }
      ]
    }
  }
}

Atbildes lauki

Lauks Tips Apraksts
site string Pieprasījumā izmantotais Tracker ID.
updated_at string UTC laikspiedols, kas norāda, kad tika izveidota atbildes informācija.
timezone string Tracker laika josla, kas izmantota vietējo datumu noteikšanai.
pulse.available boolean Norāda, vai Pulse aprēķinam ir pieejami pietiekami vēsturiskie dati.
pulse.reason string|null Iemesls, kādēļ Pulse nav pieejams.
pulse.delta_percent integer|null Kopējā procentuālā atšķirība no atskaites vērtības.
pulse.days_counted integer Atskaites vērtībā iekļauto dienu skaits.
pulse.is_provisional boolean Norāda, vai Pulse rezultāts ir provizorisks.
pulse.minute_of_day integer Salīdzināšanai izmantotā pašreizējā vietējās dienas minūte.
pulse.metrics.pageviews object Lapu skatījumu skaits šodien, vidējā vērtība un delta_percent.
pulse.metrics.visitors object Apmeklētāju skaits šodien, vidējā vērtība un delta_percent.
pulse.metrics.active_users object Aktīvo lietotāju skaits šodien, vidējā vērtība un delta_percent.
pulse.baseline object Atskaites vērtības metadati un paraugu dienas, kas izmantotas Pulse aprēķinam.
yesterday_vs_day_before object Pabeigtas dienas salīdzinājums lapu skatījumu un apmeklētāju skaita ziņā ar iepriekšējo dienu.
chart object 15 minūšu laikrinda šodienai, vakardienai un vidējai vērtībai, sadalīta lapu skatījumos un apmeklētājos.

Datu aktualitāte un kešatmiņa

Atbildes katram tracker ID tiek mikroglabātas kešatmiņā 30 sekundes, bet pārslodzes novēršanai 90 sekundes var tikt izmantota novecojusi atbilde.

Kļūdas

HTTP Kods Apraksts
400 site_required Trūkst obligātā site parametra.
401 missing_token Trūkst Authorization galvenes.
401 invalid_token Tokens nav derīgs vai ir atsaukts.
403 site_not_authorized API atslēgai nav piekļuves šim tracker ID.
429 rate_limit_exceeded Ir pārsniegts pieprasījumu biežuma ierobežojums.
503 redis_unavailable Reāllaika aizmugursistēma īslaicīgi nav pieejama. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}