Endpoint de l’API REST

GET /api/me

Contexte du compte associé à la clé API : tracker actuel et tous les trackers auxquels le token donne accès.

Requête

GET https://api.nowmetrix.com/api/me

Commencez par cet endpoint lorsqu’une intégration doit déterminer les trackers auxquels la clé API donne accès avant d’effectuer des requêtes propres à un tracker.

Authentification

Une clé API est requise dans l’en-tête Authorization, au format suivant : Authorization: Bearer nm_YOUR_KEY.

Paramètres de requête

Cet endpoint n’accepte aucun paramètre de requête.

Exemple cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/api/me"

Exemple de réponse

{
  "authenticated": true,
  "current_tracker": "TRACKER_ID",
  "trackers": [
    {
      "tracker": "TRACKER_ID",
      "host": "example-media.test"
    },
    {
      "tracker": "SECOND_TRACKER_ID",
      "host": "example-studio.test"
    }
  ]
}

Champs de réponse

Champ	Type	Description
`authenticated`	`boolean`	Indique si le token Bearer est valide.
`current_tracker`	`string`	Premier tracker accessible avec la clé API. Utilisez les identifiants de tracker du tableau trackers pour les requêtes propres à un tracker.
`trackers[]`	`array<object>`	Trackers accessibles à l’utilisateur actuel.
`trackers[].tracker`	`string`	Identifiant du tracker.
`trackers[].host`	`string`	Nom d’hôte normalisé du tracker.

Fraîcheur des données et mise en cache

Les réponses ne sont pas mises en cache. L’endpoint envoie Cache-Control: no-store, no-cache, must-revalidate, max-age=0.

Erreurs

HTTP	Code	Description
401	`missing_token`	L’en-tête Authorization est manquant.
401	`invalid_token`	Le token est invalide ou révoqué.

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