Authentifizierung

Die REST API von Statnive verwendet die standardmäßige WordPress-REST-Authentifizierung. Sie können sich mit Anwendungspasswörtern, Cookie-basierter Authentifizierung (für eingeloggte Benutzer) oder einem beliebigen Authentifizierungs-Plugin authentifizieren, das mit der WordPress REST API kompatibel ist. Alle endpoints erfordern standardmäßig die Berechtigung manage_options.

Basis-URL

Alle endpoints sind unter dem namespace statnive/v1 registriert:

https://yoursite.com/wp-json/statnive/v1/

Verfügbare Endpoints

GET /stats/summary

Gibt eine Zusammenfassung der wichtigsten Kennzahlen für einen bestimmten Datumsbereich zurück.

Parameter:

• from (string, erforderlich) — Startdatum im Format YYYY-MM-DD.
• to (string, erforderlich) — Enddatum im Format YYYY-MM-DD.

Antwort:

{
  "visitors": 1234,
  "pageviews": 3456,
  "sources": { "organic_search": 520, "social": 310, "direct": 280 },
  "top_pages": [{ "path": "/", "views": 890 }]
}

GET /stats/sources

Gibt die Aufschlüsselung der Traffic-Quellen nach Channel zurück.

GET /stats/pages

Gibt seitenbasierte Analysen, sortiert nach Seitenaufrufanzahl, zurück.

GET /stats/realtime

Gibt die aktuelle Anzahl aktiver Besucher sowie einen aktuellen Seitenaufruf-Feed zurück.

Rate Limiting

API-Anfragen sind auf 60 Anfragen pro Minute pro authentifiziertem Benutzer begrenzt. Dieses Limit wird auf Anwendungsebene durchgesetzt und gibt eine 429 Too Many Requests-Antwort zurück, wenn es überschritten wird.