API REST

Intégrez les données NowMetrix aux outils déjà utilisés par votre équipe.

Commencez par un instantané en direct, créez un affichage pour la rédaction ou envoyez des résultats historiques dans votre processus de reporting. Sélectionnez un endpoint ici, puis consultez sa référence technique complète.

Connectez votre application

Vous découvrez l’API ? Commencez par le guide complet de connexion. Il explique comment créer et protéger une clé API, la vérifier avec /api/me et effectuer la même requête authentifiée dans les langages de programmation courants.

Ouvrir le guide de connexion

Commencez par une URL de base

Toute requête authentifiée par une clé API commence par cet hôte :

https://api.nowmetrix.com

Envoyez votre clé API

Envoyez une clé API sous forme de jeton Bearer dans l’en-tête Authorization. Les administrateurs de compte et les membres de l’équipe disposant d’un accès à l’API peuvent créer et nommer jusqu’à 10 clés actives dans le tableau de bord NowMetrix, sous Paramètres -> API.

Authorization: Bearer nm_YOUR_KEY

HTTPS est obligatoire. Toutes les clés utilisent les autorisations de leur utilisateur NowMetrix et partagent la limite de requêtes de chaque tracker.

Effectuez votre première requête

Le moyen le plus rapide de tester votre configuration consiste à demander un instantané en temps réel. Il confirme que la clé fonctionne et permet d’accéder au tracker.

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

Choisissez les données dont vous avez besoin

Méthode Chemin Description Référence
GET /v1/realtime Instantané en direct actuel : utilisateurs actifs, pages vues, pages principales, appareils, pays, villes et sources. Voir l’endpoint
GET /v1/sources Sources de trafic de la fenêtre actuelle en direct, avec leur classification et, facultativement, les lignes enfants. Voir l’endpoint
GET /v1/overview Pages vues et visites quotidiennes pour les N dernières entrées historiques terminées. Voir l’endpoint
GET /v1/recap Données de récapitulatif, indicateurs clés et pages principales pour des périodes prédéfinies ou une période personnalisée. Voir l’endpoint
GET /v1/pulse Indicateurs du jour, comparaison avec la veille et courbes intrajournalières par intervalles de 15 minutes. Voir l’endpoint
GET /v1/proofreading Jusqu’à 100 suggestions de correction actuellement visibles parmi les articles d’un tracker vérifiés le plus récemment. Voir l’endpoint
GET /v1/responsibilities Responsabilités actuelles de l’équipe pour un tracker, y compris les personnes affectées à chaque rôle visible. Voir l’endpoint
GET /api/me Contexte du compte associé à la clé API : tracker actuel et tous les trackers auxquels le jeton permet d’accéder. Voir l’endpoint

Gardez des requêtes rapides et prévisibles

L’API publique autorise 20 requêtes par minute et par tracker. Les requêtes effectuées par plusieurs utilisateurs ou clés sur un même tracker partagent le même compteur.

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1783612801
Retry-After: 42
Mettez en cache les réponses de l’API dans votre propre système dès que possible. En règle générale, conservez brièvement les données en temps réel et plusieurs minutes les données historiques de la vue d’ensemble.

Lorsqu’une requête échoue

Vous ne devriez pas avoir à analyser un format différent pour chaque problème. Les erreurs de l’API utilisent un corps JSON cohérent avec un code stable lisible par machine.

HTTP Code Description
400 site_required Le paramètre site obligatoire est absent.
401 missing_token L’en-tête Authorization est absent.
401 invalid_token Le jeton est invalide ou révoqué.
403 site_not_authorized La clé API n’a pas accès à ce tracker.
429 rate_limit_exceeded La limite de requêtes a été dépassée.
503 redis_unavailable Le système backend temps réel est temporairement indisponible. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}