REST-API-Endpunkt

GET /api/me

API-Schlüssel-Kontext: aktueller Tracker und alle Tracker, auf die der Schlüssel zugreifen kann.

Anfrage

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

Verwenden Sie diesen Endpunkt als Ausgangspunkt, wenn eine Integration ermitteln muss, auf welche Tracker der API-Schlüssel zugreifen kann, bevor Tracker-spezifische Anfragen gesendet werden.

Authentifizierung

Erfordert einen API-Schlüssel im Authorization-Header: Authorization: Bearer nm_YOUR_KEY.

Query-Parameter

Dieser Endpunkt akzeptiert keine Query-Parameter.

cURL-Beispiel

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

Beispielantwort

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

Antwortfelder

Feld Typ Beschreibung
authenticated boolean Gibt an, ob das Bearer-Token gültig ist.
current_tracker string Der erste Tracker, auf den der API-Schlüssel zugreifen kann. Verwenden Sie für Tracker-spezifische Anfragen die Tracker-IDs aus dem trackers-Array.
trackers[] array<object> Tracker, auf die der aktuelle Benutzer zugreifen kann.
trackers[].tracker string Tracker-ID.
trackers[].host string Normalisierter Hostname des trackers.

Aktualität und Caching

Antworten werden nicht zwischengespeichert. Der Endpunkt sendet Cache-Control: no-store, no-cache, must-revalidate, max-age=0.

Fehler

HTTP Code Beschreibung
401 missing_token Der Authorization-Header fehlt.
401 invalid_token Das Token ist ungültig oder wurde widerrufen. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}