Endpoint REST API

GET /api/me

Kontekst konta dla klucza API: bieżący tracker oraz wszystkie trackery dostępne dla tokenu.

Żądanie

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

Jest to punkt wyjścia dla integracji, która przed wysłaniem żądań dotyczących konkretnego trackera musi ustalić, do których trackerów ma dostęp klucz API.

Uwierzytelnianie

Wymagany jest klucz API w nagłówku Authorization: Bearer nm_YOUR_KEY.

Parametry zapytania

Ten endpoint nie przyjmuje parametrów zapytania.

Przykład cURL

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

Przykładowa odpowiedź

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

Pola odpowiedzi

Pole Typ Opis
authenticated boolean Określa, czy token Bearer jest prawidłowy.
current_tracker string Pierwszy tracker dostępny dla klucza API. W żądaniach dotyczących konkretnego trackera należy używać identyfikatorów trackerów z tablicy trackers.
trackers[] array<object> Trackery dostępne dla bieżącego użytkownika.
trackers[].tracker string Identyfikator trackera.
trackers[].host string Znormalizowana nazwa hosta trackera.

Aktualność danych i buforowanie

Odpowiedzi nie są buforowane. Endpoint wysyła nagłówek Cache-Control: no-store, no-cache, must-revalidate, max-age=0.

Błędy

HTTP Kod Opis
401 missing_token Brakuje nagłówka Authorization.
401 invalid_token Token jest nieprawidłowy lub został unieważniony. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}