GET /v1/realtime | NowMetrix REST API

Αίτημα

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

Χρησιμοποιήστε αυτό το endpoint όταν ένας πίνακας ελέγχου, μια οθόνη της αίθουσας σύνταξης, μια ειδοποίηση ή μια ελαφριά ενσωμάτωση χρειάζεται την τρέχουσα κατάσταση σε πραγματικό χρόνο ενός tracker.

Έλεγχος ταυτότητας

Απαιτείται API key στην κεφαλίδα Authorization με τιμή Bearer nm_YOUR_KEY.

Παράμετροι ερωτήματος

Όνομα	Τύπος	Υποχρεωτικό	Περιγραφή
`site`	`string`	υποχρεωτικό	ID του tracker. Το API key πρέπει να έχει πρόσβαση σε αυτόν τον tracker.

Παράδειγμα cURL

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

Παράδειγμα απόκρισης

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T12:24:30+00:00",
  "total_realtime": 128,
  "total_pageviews_today": 48215,
  "total_unique_visitors_today": 31890,
  "devices": {
    "mobile": 91,
    "desktop": 37
  },
  "top_pages": [
    {
      "url": "/news/global-market-update",
      "host": "example-media.test",
      "title": "Global market update: what changed today",
      "og_image": "https://thumbs.nowmetrix.com/thumbnails/example.jpg",
      "realtime_users": 34,
      "pageviews_today": 6240,
      "sources": [
        {
          "medium": "social",
          "source": "social.example",
          "count": 18,
          "percent": 53,
          "children": []
        },
        {
          "medium": "search",
          "source": "Google Search",
          "count": 9,
          "percent": 26,
          "children": [
            {
              "label": "google.com",
              "count": 9
            }
          ]
        }
      ]
    }
  ],
  "countries": [
    {
      "code": "CH",
      "name": "Switzerland",
      "count": 52
    },
    {
      "code": "DE",
      "name": "Germany",
      "count": 31
    }
  ],
  "cities": [
    {
      "name": "Zurich",
      "count": 21
    },
    {
      "name": "Berlin",
      "count": 13
    }
  ],
  "sources_top5": [
    {
      "medium": "(none)",
      "source": "(direct)",
      "count": 44,
      "percent": 34,
      "children": []
    }
  ]
}

Πεδία απόκρισης

Πεδίο	Τύπος	Περιγραφή
`site`	`string`	ID του tracker που χρησιμοποιήθηκε για το αίτημα.
`updated_at`	`string`	Χρονική σήμανση UTC για τη στιγμή δημιουργίας των δεδομένων.
`total_realtime`	`integer`	Αριθμός ενεργών χρηστών στο τρέχον χρονικό παράθυρο σε πραγματικό χρόνο.
`total_pageviews_today`	`integer`	Συνολικές προβολές σελίδας που καταγράφηκαν σήμερα για τον tracker.
`total_unique_visitors_today`	`integer`	Κατά προσέγγιση μοναδικοί επισκέπτες που καταγράφηκαν σήμερα.
`devices.mobile`	`integer`	Ενεργοί χρήστες που ταξινομήθηκαν ως χρήστες κινητών συσκευών.
`devices.desktop`	`integer`	Ενεργοί χρήστες που ταξινομήθηκαν ως χρήστες υπολογιστών.
`top_pages[]`	`array<object>`	Έως 50 σελίδες σε πραγματικό χρόνο, ταξινομημένες με βάση τον αριθμό χρηστών σε πραγματικό χρόνο.
`top_pages[].url`	`string`	Διαδρομή σελίδας.
`top_pages[].host`	`string`	Όνομα host που αναφέρεται για τη σελίδα.
`top_pages[].title`	`string`	Τίτλος σελίδας· αν δεν υπάρχει, χρησιμοποιείται ως εναλλακτική η διαδρομή.
`top_pages[].og_image`	`string`	URL μικρογραφίας για τη σελίδα.
`top_pages[].realtime_users`	`integer`	Ενεργοί χρήστες που βρίσκονται αυτήν τη στιγμή σε αυτήν τη σελίδα.
`top_pages[].pageviews_today`	`integer`	Οι σημερινές προβολές σελίδας για αυτήν τη σελίδα.
`top_pages[].sources[]`	`array<object>`	Ανάλυση των πηγών επισκεψιμότητας για αυτήν τη σελίδα, με την ίδια μορφή γραμμών όπως στο /v1/sources.
`countries[]`	`array<object>`	Κορυφαίες χώρες με κωδικό, όνομα στα αγγλικά και πλήθος.
`cities[]`	`array<object>`	Κορυφαίες πόλεις με όνομα και πλήθος.
`sources_top5[]`	`array<object>`	Οι πέντε κορυφαίες πηγές συνολικής επισκεψιμότητας για το χρονικό παράθυρο σε πραγματικό χρόνο.

Επικαιρότητα και caching

Οι αποκρίσεις διατηρούνται σε microcache ανά tracker για 8 δευτερόλεπτα. Η απόκριση περιλαμβάνει επίσης την κεφαλίδα X-NowMetrix-Microcache με την τιμή HIT ή MISS.

Σφάλματα

HTTP	Κωδικός	Περιγραφή
400	`site_required`	Λείπει η απαιτούμενη παράμετρος site.
401	`missing_token`	Λείπει η κεφαλίδα Authorization.
401	`invalid_token`	Το token δεν είναι έγκυρο ή έχει ανακληθεί.
403	`site_not_authorized`	Το API key δεν έχει πρόσβαση σε αυτόν τον tracker.
429	`rate_limit_exceeded`	Έχει ξεπεραστεί το όριο ρυθμού αιτημάτων.
503	`redis_unavailable`	Το backend δεδομένων σε πραγματικό χρόνο δεν είναι προσωρινά διαθέσιμο.

{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}