Endpoint του REST API

GET /v1/pulse

Η σημερινή εικόνα, η σύγκριση με τη χθεσινή ημέρα και οι ενδοημερήσιες καμπύλες ανά 15 λεπτά.

Αίτημα

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

Χρησιμοποιήστε το Pulse για να απαντήσετε σε μια πιο χρήσιμη ερώτηση από το «Πόση επισκεψιμότητα έχουμε;»: είναι η σημερινή κίνηση πάνω ή κάτω από το συνηθισμένο μοτίβο για τη συγκεκριμένη ημέρα και ώρα;

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

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

Παράμετροι query

Όνομα Τύπος Απαιτείται Περιγραφή
site string απαιτείται Tracker ID. Το κλειδί API πρέπει να έχει πρόσβαση σε αυτό το tracker.

Παράδειγμα cURL

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

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

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

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

Πεδίο Τύπος Περιγραφή
site string Το Tracker ID που χρησιμοποιήθηκε για το αίτημα.
updated_at string Χρονική σήμανση UTC για τη δημιουργία των δεδομένων.
timezone string Η ζώνη ώρας του tracker που χρησιμοποιείται για τον προσδιορισμό των τοπικών ημερομηνιών.
pulse.available boolean Αν υπάρχει επαρκές ιστορικό για τον υπολογισμό του Pulse.
pulse.reason string|null Ο λόγος για τον οποίο το Pulse δεν είναι διαθέσιμο.
pulse.delta_percent integer|null Η συνολική ποσοστιαία διαφορά από την τιμή αναφοράς.
pulse.days_counted integer Ο αριθμός των ημερών αναφοράς που περιλαμβάνονται.
pulse.is_provisional boolean Αν το αποτέλεσμα του Pulse είναι προσωρινό.
pulse.minute_of_day integer Το τρέχον λεπτό της τοπικής ημέρας που χρησιμοποιείται για τη σύγκριση.
pulse.metrics.pageviews object Οι σημερινές Προβολές σελίδας, ο μέσος όρος και το delta_percent.
pulse.metrics.visitors object Οι σημερινοί επισκέπτες, ο μέσος όρος και το delta_percent.
pulse.metrics.active_users object Οι σημερινοί ενεργοί χρήστες, ο μέσος όρος και το delta_percent.
pulse.baseline object Μεταδεδομένα της τιμής αναφοράς και οι ημέρες-δείγματα που χρησιμοποιήθηκαν για τον υπολογισμό του Pulse.
yesterday_vs_day_before object Σύγκριση ολοκληρωμένων ημερών για τις Προβολές σελίδας και τους επισκέπτες.
chart object Σειρές ανά 15 λεπτά για σήμερα, χθες και τον μέσο όρο, χωρισμένες σε Προβολές σελίδας και επισκέπτες.

Επικαιρότητα και προσωρινή αποθήκευση

Οι αποκρίσεις αποθηκεύονται προσωρινά ανά tracker για 30 δευτερόλεπτα, με παράθυρο εξυπηρέτησης παρωχημένων δεδομένων διάρκειας 90 δευτερολέπτων για προστασία από αιχμές.

Σφάλματα

HTTP Κωδικός Περιγραφή
400 site_required Λείπει η απαιτούμενη παράμετρος site.
401 missing_token Λείπει η κεφαλίδα Authorization.
401 invalid_token Το token δεν είναι έγκυρο ή έχει ανακληθεί.
403 site_not_authorized Το κλειδί API δεν έχει πρόσβαση σε αυτό το tracker.
429 rate_limit_exceeded Έχει γίνει υπέρβαση του ορίου ρυθμού αιτημάτων.
503 redis_unavailable Το backend δεδομένων πραγματικού χρόνου δεν είναι προσωρινά διαθέσιμο. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}