REST API-endpoint

GET /api/me

Accountcontext voor de API-sleutel: de huidige tracker en alle trackers waartoe de token toegang heeft.

Aanvraag

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

Gebruik dit endpoint als eerste wanneer een integratie moet vaststellen tot welke trackers de API-sleutel toegang heeft, voordat tracker-specifieke aanvragen worden gedaan.

Authenticatie

Vereist een API-sleutel in de Authorization-header: Authorization: Bearer nm_YOUR_KEY.

Queryparameters

Dit endpoint accepteert geen queryparameters.

cURL-voorbeeld

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

Voorbeeldresponse

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

Responsevelden

Veld Type Beschrijving
authenticated boolean Geeft aan of de Bearer-token geldig is.
current_tracker string Eerste tracker die beschikbaar is voor de API-sleutel. Gebruik tracker-ID’s uit de trackers-array voor tracker-specifieke aanvragen.
trackers[] array<object> Trackers die beschikbaar zijn voor de huidige gebruiker.
trackers[].tracker string Tracker-ID.
trackers[].host string Genormaliseerde hostnaam voor de tracker.

Cachegedrag

Responses worden niet gecachet. Het endpoint verstuurt Cache-Control: no-store, no-cache, must-revalidate, max-age=0.

Foutmeldingen

HTTP Code Beschrijving
401 missing_token De Authorization-header ontbreekt.
401 invalid_token De token is ongeldig of ingetrokken. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}