REST API

Gebruik NowMetrix-gegevens in de tools die uw team al gebruikt.

Begin met een live momentopname, bouw een redactioneel scherm of stuur historische resultaten naar uw rapportageproces. Kies hier een endpoint en open vervolgens de volledige technische documentatie.

Verbind uw applicatie

Nieuw met de API? Begin met de volledige verbindingshandleiding. Daarin leest u hoe u een API-sleutel aanmaakt en beveiligt, deze verifieert met /api/me en hetzelfde geauthenticeerde verzoek uitvoert vanuit veelgebruikte programmeertalen.

Open de verbindingshandleiding

Begin met één basis-URL

Elk verzoek waarvoor een API-sleutel nodig is, begint met deze host:

https://api.nowmetrix.com

Stuur uw API-sleutel mee

Stuur een API-sleutel als Bearer-token mee in de Authorization-header. Accountbeheerders en teamleden met API-toegang kunnen in het NowMetrix-dashboard onder Instellingen -> API maximaal 10 actieve sleutels aanmaken en labelen.

Authorization: Bearer nm_YOUR_KEY

HTTPS is vereist. Alle sleutels gebruiken de rechten van de bijbehorende NowMetrix-gebruiker en delen dezelfde verzoeklimiet per tracker.

Voer uw eerste verzoek uit

Een realtime momentopname is de snelste manier om uw configuratie te testen. Zo controleert u of de sleutel werkt en toegang heeft tot de tracker.

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

Kies de gegevens die u nodig hebt

Methode Pad Beschrijving Naslagwerk
GET /v1/realtime Actuele live momentopname: actieve gebruikers, Pageviews, Toppagina’s, apparaten, landen, steden en bronnen. Endpoint bekijken
GET /v1/sources Verkeersbronnen uit het huidige livevenster, met classificatie en optionele onderliggende rijen. Endpoint bekijken
GET /v1/overview Dagelijkse Pageviews en bezoeken voor de laatste N afgeronde historische rijen. Endpoint bekijken
GET /v1/recap Recap-gegevens, samenvattende statistieken en Toppagina’s voor vooraf ingestelde of aangepaste datumbereiken. Endpoint bekijken
GET /v1/pulse Pulse van vandaag, vergelijking met gisteren en intradaycurves per 15 minuten. Endpoint bekijken
GET /v1/proofreading Maximaal 100 momenteel zichtbare suggesties voor taalcontrole uit de meest recent gecontroleerde artikelen van één tracker. Endpoint bekijken
GET /v1/responsibilities Actuele teamverantwoordelijkheden voor een tracker, inclusief wie aan elke zichtbare rol is toegewezen. Endpoint bekijken
GET /api/me Accountcontext van de API-sleutel: de huidige tracker en alle trackers waartoe het token toegang heeft. Endpoint bekijken

Houd verzoeken snel en voorspelbaar

De openbare API staat 20 verzoeken per minuut per tracker toe. Meerdere gebruikers of sleutels die dezelfde tracker opvragen, delen dezelfde teller.

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1783612801
Retry-After: 42
Cache API-antwoorden waar mogelijk in uw eigen systeem. Als vuistregel kunt u realtimegegevens kort cachen en historische overzichtsgegevens enkele minuten bewaren.

Wanneer een verzoek mislukt

U hoeft niet voor elk probleem een ander formaat te verwerken. API-fouten gebruiken een consistente JSON-body met een stabiele, machineleesbare code.

HTTP Code Beschrijving
400 site_required De vereiste siteparameter ontbreekt.
401 missing_token De Authorization-header ontbreekt.
401 invalid_token Het token is ongeldig of ingetrokken.
403 site_not_authorized De API-sleutel heeft geen toegang tot deze tracker.
429 rate_limit_exceeded De verzoeklimiet is overschreden.
503 redis_unavailable De realtimebackend is tijdelijk niet beschikbaar. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}