REST API

Bringed Si NowMetrix-Date i d’Tools, wo Ihr Team scho bruucht.

Started Si mit ere Live-Übersicht, baued Si es Newsroom-Display oder schicked Si historischi Ergebnis i Ihri Reporting-Abläuf. Wähled Si da en Endpoint uus und öffned Si denn d’vollständigi technische Referenz.

Ihri Applikation verbinde

Sind Si neu bi de API? Started Si mit de vollständige Aaleitig zum Verbinde. Si zeigt Ihne, wie Si en API-Key chönd erstellä und schütze, ihn mit /api/me prüefed und di gliichi authentifizierti Anfrage us gängige Programmierspraache schicked.

Aaleitig zum Verbinde öffne

Mit ere Basis-URL starte

Jedi authentifizierti Anfrage mit API-Key startet mit dem Host:

https://api.nowmetrix.com

API-Key schicke

Schicked Si en API-Key als Bearer-Token im Authorization-Header. Konto-Admins und Teammitglieder mit API-Zuegriff chönd im NowMetrix-Dashboard under Iistellige -> API bis zu 10 aktivi Keys erstellä und beschrifte.

Authorization: Bearer nm_YOUR_KEY

HTTPS isch erforderlich. Alli Keys händ d’Berechtigunge vo ihrem NowMetrix-Benutzer und teile s’Rate-Limit vo ihrem Tracker.

Ihri erscht Anfrage mache

Am schnellste tested Si Ihri Iistellig mit ere Echtziit-Übersicht. Si bestätigt, dass de Key funktioniert und uf de Tracker zuegreife cha.

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

D’Date uuswähle, wo Si bruuched

Methode Pfad Beschriibig Referenz
GET /v1/realtime Aktuelli Live-Übersicht: aktivi Benutzer, Pageviews, Top-Siite, Grät, Länder, Städt und Quälle. Endpoint aaluege
GET /v1/sources Traffic-Quälle im aktuelle Live-Ziitfänschter mit Klassifizierig und optionale Unterziile. Endpoint aaluege
GET /v1/overview Täglichi Pageviews und Bsüech für d’letschte N abgloffene Verlaufsziile. Endpoint aaluege
GET /v1/recap Recap-Date, Zämefassigs-Metrike und Top-Siite für Vorgabe oder en eigene Datumsbereich. Endpoint aaluege
GET /v1/pulse De Pulse vo hüt, de Vergliich mit geschter und Intraday-Kurve im 15-Minute-Takt. Endpoint aaluege
GET /v1/proofreading Bis zu 100 aktuell sichtbari Textprüefig-Vorschläg vo de zuletscht geprüefte Artikel vo eim Tracker. Endpoint aaluege
GET /v1/responsibilities Aktuelli Team-Zueständigkeite für en Tracker, inklusive de Zuewiisig zu jeder sichtbare Rolle. Endpoint aaluege
GET /api/me Konto-Kontext vom API-Key: de aktuelle Tracker und alli Tracker, uf wo de Token zuegreife cha. Endpoint aaluege

Anfrage schnell und berechenbar halte

D’öffentligi API erlaubt 20 Anfrage pro Minute und Tracker. Mehreri Benutzer oder Keys, wo de gliiche Tracker abfröged, teile de gliiche Zähler.

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1783612801
Retry-After: 42
Speichered Si API-Antworte wenn immer möglich i Ihrem eigene System. Als Richtwert: Speichered Si Echtziit-Date churz und historischi Overview-Date für mehri Minute.

Wenn e Anfrage fählt

Si müend nöd für jedes Problem es anders Format verarbeite. API-Fähler verwänded en einheitliche JSON-Body mit eme stabile, maschinell läsbare Code.

HTTP Code Beschriibig
400 site_required De erforderligi Site-Parameter fehlt.
401 missing_token De Authorization-Header fehlt.
401 invalid_token De Token isch ungültig oder widerruefe worde.
403 site_not_authorized De API-Key het kei Zuegriff uf dä Tracker.
429 rate_limit_exceeded S’Rate-Limit isch überschritte worde.
503 redis_unavailable S Echtziit-Backend isch vorübergehend nöd verfüegbar. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}