GET /v1/overview | Τεκμηρίωση REST API NowMetrix

Αίτημα

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

Αυτό είναι το σύντομο endpoint για αναφορές τάσεων, εισαγωγές σε εργαλεία BI, εξαγωγές σε υπολογιστικά φύλλα και απλές εβδομαδιαίες ή μηνιαίες συνόψεις.

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

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

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

Όνομα	Τύπος	Υποχρεωτική	Περιγραφή
`site`	`string`	υποχρεωτική	Tracker ID. Το κλειδί API πρέπει να έχει πρόσβαση σε αυτό το tracker.
`days`	`integer`	προαιρετική	Αριθμός ημερών που θα επιστραφούν. Οι τιμές περιορίζονται στο διάστημα 1–30. Προεπιλογή: 30.

Παράδειγμα cURL

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

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

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

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

Πεδίο	Τύπος	Περιγραφή
`site`	`string`	Το Tracker ID που χρησιμοποιήθηκε για το αίτημα.
`timezone`	`string`	Η ζώνη ώρας του tracker που χρησιμοποιείται για τον προσδιορισμό των τοπικών ημερομηνιών.
`range.from`	`string`	Η πρώτη ημερομηνία στον ημερήσιο πίνακα που επιστράφηκε.
`range.to`	`string`	Η τελευταία ημερομηνία στον ημερήσιο πίνακα που επιστράφηκε.
`range.days`	`integer`	Ο αριθμός των ημερήσιων εγγραφών που επιστράφηκαν.
`daily[]`	`array<object>`	Ημερήσιες εγγραφές ταξινομημένες κατά αύξουσα ημερομηνία.
`daily[].date`	`string`	Ημερομηνία στη μορφή YYYY-MM-DD.
`daily[].pageviews`	`integer`	Προβολές σελίδας για τη συγκεκριμένη ημερομηνία.
`daily[].visits`	`integer`	Επισκέψεις για τη συγκεκριμένη ημερομηνία.
`totals.pageviews`	`integer`	Το άθροισμα των προβολών σελίδας στις ημερήσιες εγγραφές που επιστράφηκαν.
`totals.visits`	`integer`	Το άθροισμα των επισκέψεων στις ημερήσιες εγγραφές που επιστράφηκαν.

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

Οι αποκρίσεις αποθηκεύονται προσωρινά ανά tracker και τιμή days για 60 δευτερόλεπτα, με ένα σύντομο περιθώριο σερβιρίσματος παρωχημένων δεδομένων για προστασία από αιχμές.

Σφάλματα

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

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