Endpoint REST API

GET /api/me

Kontext účtu podle API klíče: aktuální tracker a všechny trackery, ke kterým má token přístup.

Požadavek

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

Začněte zde, pokud integrace potřebuje zjistit, ke kterým trackerům má API klíč přístup, než odešle požadavky pro konkrétní trackery.

Autentizace

Vyžaduje API klíč v hlavičce Authorization ve formátu Bearer nm_YOUR_KEY.

Parametry dotazu

Tento endpoint nepřijímá parametry dotazu.

Příklad cURL

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

Příklad odpovědi

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

Pole odpovědi

Pole	Typ	Popis
`authenticated`	`boolean`	Určuje, zda je token Bearer platný.
`current_tracker`	`string`	První tracker dostupný pro API klíč. Pro požadavky ke konkrétním trackerům použijte ID trackerů z pole trackers.
`trackers[]`	`array<object>`	Trackery dostupné aktuálnímu uživateli.
`trackers[].tracker`	`string`	ID trackeru.
`trackers[].host`	`string`	Normalizovaný název hostitele trackeru.

Aktuálnost a ukládání do mezipaměti

Odpovědi se neukládají do mezipaměti. Endpoint odesílá Cache-Control: no-store, no-cache, must-revalidate, max-age=0.

Chyby

HTTP	Kód	Popis
401	`missing_token`	Chybí hlavička Authorization.
401	`invalid_token`	Token je neplatný nebo byl zneplatněn.

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