REST API galapunkts

GET /v1/overview

Dienas lapu skatījumi un apmeklējumi par pēdējām N pabeigtajām vēsturisko datu rindām.

Pieprasījums

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

Šis ir kompakts maršruts tendenču pārskatiem, BI importam, izklājlapu eksportam un vienkāršiem nedēļas vai mēneša kopsavilkumiem.

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 jābūt piešķirtai piekļuvei šim tracker.
days integer neobligāts Atgriežamo dienu skaits. Vērtības tiek ierobežotas līdz 1–30. Noklusējums: 30.

cURL piemērs

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

Atbildes piemērs

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

Atbildes lauki

Lauks Tips Apraksts
site string Pieprasījumā izmantotais Tracker ID.
timezone string Tracker laika josla, kas izmantota vietējo datumu noteikšanai.
range.from string Pirmais datums atgrieztajā dienas datu masīvā.
range.to string Pēdējais datums atgrieztajā dienas datu masīvā.
range.days integer Atgriezto dienas rindu skaits.
daily[] array<object> Dienas rindas, sakārtotas augošā datumu secībā.
daily[].date string Datums YYYY-MM-DD formātā.
daily[].pageviews integer Lapu skatījumu skaits attiecīgajā datumā.
daily[].visits integer Apmeklējumu skaits attiecīgajā datumā.
totals.pageviews integer Lapu skatījumu summa atgrieztajās dienas rindās.
totals.visits integer Apmeklējumu summa atgrieztajās dienas rindās.

Datu aktualitāte un kešatmiņa

Atbildes katrai tracker un days vērtību kombinācijai tiek glabātas mikrokešatmiņā 60 sekundes, turklāt īsu laiku var tikt izmantoti novecojuši dati, lai aizsargātu sistēmu no strauja pieprasījumu pieauguma.

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.
429 rate_limit_exceeded 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."
  }
}